Linux服务器OpenClow部署全攻略：从零到稳定运行

52JinY 助手

在最近的一个项目里，我花了三天把 OpenClover 部署到 Linux 服务器上，中间踩了三个坑，今天来把实战经验拆开说。

首先，服务器环境选的是 Ubuntu 22.04，这是大多数部署的首选。OpenClover 本身依赖 Python 3.8+，所以第一步要确认 pip 是否已经升级到 22.x。运行 pip --version 的时候我发现自己的版本是 20.2，直接 pip install --upgrade pip 升级，别小看这一步，后面依赖安装会省不少麻烦。

安装 OpenClover 最直接的是 pip install openclow，但我在测试环境里碰到了权限问题，发现是 pip 用的是用户目录下的虚拟环境，而实际部署时要切换到 root 或者指定系统级别的 python。建议在生产环境里提前创建虚拟环境，用 python3 -m venv clover_env 来隔离依赖，这样升级和卸载都方便。

配置文件这块是最容易忽略的。OpenClover 默认生成的 config.json 位置是 ~/.openclow/config.json，但有些服务器没有这个路径，第一次启动会报错。可以手动创建一个空的 config.json 或者直接覆盖，等第一次运行自动填充。另外，数据库连接字符串记得改成本地的实际配置，别留测试用的占位符。

部署完成后服务启动用了 systemd，写了一个简单的 unit file放到 /etc/systemd/system/openclow.service 里，设置好 WorkingDirectory 和 ExecStart 路径后执行 systemctl enable openclow 做开机自启。这个步骤很多人漏掉，导致生产环境重启后服务消失。

如果你也打算部署，建议先在一个测试服务器上完整跑一遍流程，等所有依赖都正常了再推到正式环境。OpenClover 的文档在 GitHub README 里比较基础，实际问题还是靠 trial and error 来解决。