DuoboxDocs

Duobox Server

初始化、后台运行并管理承载 Organization Space 的协作服务。

Duobox Server 管理 Space、Git repository、项目 ACL 和同步授权。Downcity Federation 管理 Organization 与 Membership。一个 Server 实例绑定一个 Federation 和 City。

初始化与运行

duobox server init
duobox server start
duobox server status

初始化会交互式写入权限为 0600~/.duobox/server.env,并询问 Federation URL、Bureau Token、City ID、监听地址、公开地址和数据目录。Bureau Token 输入时不会回显。

server start 会启动后台进程,健康检查通过后归还终端。运行文件位于配置的数据目录:

  • server.pid 记录受管理进程;
  • server.log 保存后台日志;
  • SQLite 数据库保存 Space、项目 ACL 和审计信息;
  • bare repositories 保存 Space 内容与历史。
duobox server restart
duobox server stop
duobox server start --foreground

只有前台调试或交给 systemd、Docker、Dokploy 等外部进程管理器时,才使用 start --foreground。不带参数的 start 由 Duobox 自己管理后台进程。

Organization 配置与项目权限

duobox login
duobox server organization list
duobox server organization link <organization-id-or-key>
duobox server organization access list <organization-id>
duobox server organization access set <organization-id> <user-id> --role editor
duobox server organization access remove <organization-id> <user-id>

备份时应整体备份配置的数据目录,确保数据库与 bare repositories 保持一致。

本页内容