升级
先 git fetch --tags 并检出要升级到的发布标签,再执行 upgrade。脚本先备份再升级,备份失败就停下来;数据库在服务启动时自动迁移。
sudo ./scripts/suduo-cloud.sh upgrade每个团队装一次
保存项目、需求、评论、附件和讨论房间。一台装有 Docker 的 Linux 服务器,一个脚本装好。
每人装一次
运行 SuDuo 客户端和 Codex CLI。代码仓库、Codex 会话和模型凭据都留在这里。
在服务器上依次执行。HTTPS、日常运维和常见问题见完整的部署指南。
在 Ubuntu 上可以用系统自带的软件包,也可以用 Docker 官方的安装源。
sudo apt update
sudo apt install -y docker.io docker-compose-v2 docker-buildx git请用发布标签,不要直接用 main。客户端和服务端应使用同一个版本,版本不一致时客户端会提示。
git clone https://github.com/Im-Sue/suduo-workbench.git
cd suduo-workbench
git checkout "$(git describe --tags --abbrev=0)" # 最新的发布版本
cd cloud在国内用 --mirror cn 走国内镜像源构建,海外去掉它。首次构建约 3–8 分钟,就绪后脚本会打印访问地址。
sudo ./scripts/suduo-cloud.sh install --mirror cn脚本的提示跟随服务器的系统语言,Ubuntu 服务器默认常是英文。想看中文提示,把 SUDUO_LOCALE=zh-CN 写在 sudo 后面(写在前面不起作用):
sudo SUDUO_LOCALE=zh-CN ./scripts/suduo-cloud.sh install --mirror cn拿到地址以后,团队成员在客户端的「设置 → 需求服务」里填上它,注册账号就能开始用。
同一个脚本负责日常运维,命令都在服务器的 cloud/ 目录下执行。
先 git fetch --tags 并检出要升级到的发布标签,再执行 upgrade。脚本先备份再升级,备份失败就停下来;数据库在服务启动时自动迁移。
sudo ./scripts/suduo-cloud.sh upgrade数据库和附件、房间文件一起备份,保证两边对得上。备份期间服务会暂停,时长随数据量增加;默认存到 /var/backups/suduo/<时间戳>。
sudo ./scripts/suduo-cloud.sh backup用备份替换当前全部数据:先把当前数据备份一份,再恢复,并按当前检出的版本启动。所以回滚就是检出旧版本标签,再恢复升级前的那份备份。
sudo ./scripts/suduo-cloud.sh restore /var/backups/suduo/<时间戳>两种方式任选其一,装好后都连到团队的服务端。不需要另外安装 Codex:桌面应用自带,从源码运行时 pnpm install 会装上这个版本测试过的 Codex CLI。
下载安装就能用,不用装 Node.js 和 pnpm。关掉窗口后 SuDuo 留在菜单栏(macOS)或通知区域(Windows)继续运行,进行中的会话不中断,共享进房间的 Codex 也照常回答。
下载最新版本| 电脑 | 文件 |
|---|---|
| macOS 13.5 及以上,Apple 芯片 | SuDuo-<版本>-mac-arm64.dmg |
| macOS 13.5 及以上,Intel | SuDuo-<版本>-mac-x64.dmg |
| Windows 10 / 11(x64) | SuDuo-Setup-<版本>-x64.exe |
SHA256SUMS.txt 列出了每个文件的校验值。macOS 用终端、Windows 用 PowerShell,命令相同。需要 Node.js 24(24.10 或更新)、pnpm 10.25 和 git。
git clone https://github.com/Im-Sue/suduo-workbench.git
cd suduo-workbench
git checkout "$(git describe --tags --abbrev=0)" # 和服务器用同一个版本
cd client
pnpm install
pnpm startpnpm start 会检查环境,首次运行时构建(约 1–2 分钟),在 http://127.0.0.1:8787 启动并打开浏览器。按 Ctrl+C 停止。
从 npm 下载很慢或失败时(例如在国内),先执行 pnpm config set registry https://registry.npmmirror.com,再 pnpm install。
~/.codex,你在终端里用的 Codex CLI 也跟着改),或用 Codex 登录 ChatGPT(从源码运行时在 client/ 目录下执行 pnpm exec codex login,桌面应用的命令见客户端指南)