自托管部署
在自己的基础设施上运行工作台,开发机通过连接器接入。
环境与架构
需要 Node.js 22.16+、pnpm,以及启用 pgvector 的 PostgreSQL。推荐通过 Docker 运行数据库。单个 Node.js 服务同时提供官网、文档、React 工作台与 HTTP API。
本仓库已有 CI/CD、Dockerfile 和受限 SSH 发布流程。以下区分新环境部署和现有生产环境维护,避免将运维脚本误当作通用安装器。
从源码启动
git clone https://github.com/Gausons/auto-workflow.git
cd auto-workflow
pnpm install --frozen-lockfile
cp .env.example .env新环境可用仓库的 PostgreSQL Compose 配置。先生成本地密码文件,以下命令仅在文件不存在时创建,不覆盖已有密码。
umask 077
mkdir -p .workflow-data/postgres-dev
chmod 700 .workflow-data/postgres-dev
[ -f .workflow-data/postgres-dev/admin-password ] || openssl rand -hex 32 > .workflow-data/postgres-dev/admin-password
[ -f .workflow-data/postgres-dev/app-password ] || openssl rand -hex 32 > .workflow-data/postgres-dev/app-password
chmod 644 .workflow-data/postgres-dev/app-password
docker compose -f compose.postgres.yaml up -d --wait把应用密码文件内容填入 .env 的 PGPASSWORD,其余数据库配置如下。已有数据卷不会重新初始化;覆盖文件不能更改已有数据库密码。
DATABASE_DRIVER=postgres
PGHOST=127.0.0.1
PGPORT=15432
PGDATABASE=auto_workflow
PGUSER=auto_workflow
PGPASSWORD=replace-with-generated-app-password
HOST=127.0.0.1
PORT=4173
LOCAL_EXECUTION_ENABLED=falsepnpm build
node --import tsx --import ./src/issueSources/preload.ts server.ts使用进程管理器持久运行该 Node 命令。浏览器访问 http://127.0.0.1:4173。开发模式使用 pnpm dev,其前置脚本会清理 4173 端口,运行前注意已有服务。
HTTPS 与 WebSocket 代理
公网通过 Nginx 和有效 TLS 证书访问,应用端口仅监听回环地址。代理需要保留 Host,并支持 /api/realtime 升级为 WebSocket。以下片段放在已配置 TLS 的 server 中:
location / {
proxy_pass http://127.0.0.1:4173;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /api/realtime {
proxy_pass http://127.0.0.1:4173;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_read_timeout 120s;
}Google 登录需额外配置 GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET 与完整的 HTTPS 回调地址 /api/auth/google/callback。
升级团队协作空间
包含团队协作功能的服务启动时自动执行 migrations/postgres/009_team_workspaces.sql,创建团队、账号成员映射与邀请表。已有个人账号、任务和登录身份保留,不自动迁移到新团队。
按现有发布流程备份数据库与配置后升级,并检查健康状态、个人登录、团队创建和空间切换。数据库迁移不随容器回滚;仅支持较早 schema 版本的旧服务无法直接使用升级后的数据库,恢复前应核对数据库版本兼容性。新团队需要单独配置数据源并接入设备。
现有生产环境发布与备份
本项目 main 检查通过后,CI 构建并验证镜像,按 commit SHA / digest 发布到服务器。生产容器名为 auto-workflow,配置在 /etc/auto-workflow,运行数据在 /var/lib/auto-workflow。
发布前备份数据库和配置,健康检查失败恢复旧容器。数据库不自动回滚,避免覆盖数据或重复执行指令。备份位于 /opt/auto-workflow/backups/;需定期验证恢复并检查磁盘。
docker ps --filter name=auto-workflow
docker logs --tail 100 auto-workflow
docker inspect --format '{{.State.Health.Status}}' auto-workflow
curl --fail https://your-workbench.example.com/api/health更完整的服务器初始化、受限 SSH 安装与迁移过程见仓库 README。不要对已有卷执行 docker compose down -v。