anybox: Skill for Codex

腾讯云 Docker 部署 anyboxProvider

概览

这个 skill 固定用于当前项目的腾讯云部署流程：

• 本地项目目录：C:\Projects\anyboxProvider
• 服务器 SSH 别名：anybox-server
• 服务器实际地址：[email protected]
• 服务器部署根目录：/home/ubuntu/
• 服务器项目目录：/home/ubuntu/anyboxProvider
• 部署方式：docker-compose.tencent.yml 和 scripts/tencent-deploy.sh

采用简单优先策略：本地维护并上传 .env.tencent。不要上传 .env、node_modules、dist 或 .git。

部署前检查

先确认服务器上的 Docker 可用：

ssh anybox-server 'docker --version && docker compose version && docker ps'

如果本地 shell 没有配置好 SSH，就让用户在 VS Code 远程终端里手动执行上面的检查命令，不要临时改用其他服务器或其他部署目标。

打包并上传

在本机 PowerShell 7 中执行：

cd C:\Projects

tar -czf anyboxProvider.tar.gz `
  --exclude=anyboxProvider/node_modules `
  --exclude=anyboxProvider/dist `
  --exclude=anyboxProvider/.env `
  --exclude=anyboxProvider/.git `
  anyboxProvider

scp .\anyboxProvider.tar.gz anybox-server:/home/ubuntu/

如果本地已有旧的压缩包，只能删除 C:\Projects\anyboxProvider.tar.gz，不要删除源项目文件。

在服务器解压

在腾讯云服务器上执行：

cd /home/ubuntu

if [ -d anyboxProvider ]; then
  mv anyboxProvider "anyboxProvider.backup.$(date +%Y%m%d-%H%M%S)"
fi

tar -xzf anyboxProvider.tar.gz
cd anyboxProvider

如果用户临时决定不上传 .env.tencent，更新部署时需要从旧备份复制回来：

cp ../anyboxProvider.backup.*/.env.tencent .env.tencent 2>/dev/null || true

如果存在多个备份目录，显式选择最新的备份目录，不要依赖通配符。

配置生产环境变量

简单优先时，先在本地 C:\Projects\anyboxProvider\.env.tencent 填好生产配置，然后随压缩包一起上传。若本地还没有该文件，先在本地复制模板：

cd C:\Projects\anyboxProvider
Copy-Item .env.tencent.example .env.tencent
notepad .env.tencent

如果要在服务器上直接编辑，也可以执行：

cp .env.tencent.example .env.tencent
nano .env.tencent

至少替换这些值：

APP_DOMAIN=你的域名
APP_BASE_URL=https://你的域名

POSTGRES_PASSWORD=<随机 hex>
DATABASE_URL=postgres://anybox:<同一个 PostgreSQL 密码>@postgres:5432/anybox_provider

REDIS_PASSWORD=<随机 hex>
REDIS_URL=redis://:<同一个 Redis 密码>@redis:6379

SESSION_SECRET=<随机 hex>
ENCRYPTION_KEY=<随机 hex，必须稳定保存和备份>
METRICS_TOKEN=<随机 hex>
ADMIN_TOKEN=<随机 hex>

ADMIN_BOOTSTRAP_EMAIL=<管理员邮箱>
ADMIN_BOOTSTRAP_PASSWORD=<初始管理员密码>

DEFAULT_PROVIDER_API_KEY=<上游模型供应商 API Key>