Skip to content

系统设置 ​

四个 tab 概览 ​

/settings 重定向到 /settings/profile,侧边菜单含四个子页:

tab路径查看修改
个人设置/settings/profile本人本人
用户管理/settings/users仅 admin仅 admin
凭据/settings/credentials登录用户登录用户;生成服务器 SSH 密钥仅 admin
系统设置/settings/system登录用户(只读模式)仅 admin

系统设置(system) ​

「运行与日志」表单,非 admin 打开时整表只读并提示「只读模式」:

配置项默认值说明
webRoot 工作区根目录/srv/deploy/workspaces新建项目工作目录的默认根路径;修改不会搬动已有目录
serverUrl 服务端外部地址空对外访问 URL(须以 http(s)😕/ 开头),用于通知等场景拼接链接
maxConcurrentRuns 全局最大并发运行数51-200;超出的新运行进入 queued 排队
logRetentionDays 日志保留天数300 表示不自动清理
logMaxBytes 单条日志大小上限(字节)104857600(100 MiB)最小 1024,超出后截断并提示
hookRateLimitPerMinute Hook 每分钟限流60单 Token 每分钟最大触发次数
visibility 项目可见性allReadableallReadable 其他登录用户只读可见 / ownerOnly 仅归属者可见
allowRegistration 开放注册关闭开启后任何人都能通过注册接口创建账号

热生效:日志清理与并发上限等配置由服务端热读取,保存后立即生效,无需重启 (页面底部有明确提示)。webRoot 只影响之后的预填与新建,不迁移存量目录。

通知卡片为只读展示:启用状态、Webhook 地址、触发条件(success / failed / all)、 当前日志策略摘要。Web 端不提供编辑入口,通知配置在服务端配置文件中维护, 见启动参数与配置文件。

页面另有「去环境自检」链接——自检与工具链安装已迁至 /doctor,见环境自检。

visibility 与开放注册的安全含义 ​

  • allReadable 适合互相信任的小团队:所有人能看到彼此的项目与日志(只读), 但日志可能含敏感输出;ownerOnly 适合多租户 / 跨团队共用,普通用户只见自己的对象, admin 始终全量可见。权限矩阵见用户、角色与可见性。
  • 开放注册默认关闭。本平台本质是远程命令执行,开启注册等于允许任何人获得 脚本执行能力,公网环境务必保持关闭并配合反代与 HTTPS,见安全加固。

用户管理(users,仅 admin) ​

操作说明
搜索按用户名 / 昵称关键字过滤
新建用户用户名(2-32 位字母数字 _.-)、初始密码(至少 8 位)、昵称、邮箱、角色(admin / user,默认 user)
编辑修改昵称、邮箱、角色、状态(active 正常 / disabled 禁用)
重置密码设置新密码(至少 8 位);对方下次登录被要求首次改密
删除二次确认;不能删除自己(本人行不显示删除按钮)

列表展示角色、状态、最近登录时间,本人行带「自己」标签。 通过本页创建的账号带 mustChangePassword 标记,见登录与初始化。

凭据(credentials) ​

Git 凭据表:名称、类型(HTTPS Token / SSH 私钥)、用户名、创建时间。

  1. 新建:选类型后填字段——HTTPS Token 需用户名 + Token;SSH 私钥的用户名可选 (默认 git),粘贴私钥内容,可另填 passphrase。
  2. 编辑:密文字段留空表示保持原值不变。
  3. 连接测试:在编辑弹窗内点「测试连接」,填仓库地址与可选分支, 服务端执行 git ls-remote 验证连通性与认证。
  4. 删除:被项目引用时服务端拒绝删除并提示。

密文加密存储、只在服务端使用,详见凭据与 API Token。

服务器 SSH 公钥卡片:展示服务端自身 ~/.ssh 下的公钥(与数据库凭据是两回事), 含类型、路径、指纹与一键复制。生成密钥(仅 admin):

  1. 选择类型:ed25519 或 rsa(4096 位)。
  2. 点「生成 SSH 密钥」并确认;同类型密钥已存在时按钮置灰,不会覆盖。
  3. 复制公钥添加到 Git 平台(Deploy Key / 账号 SSH Key),即可用 SSH 地址拉取私有仓库。

个人设置(profile) ​

卡片内容
账号信息用户名、昵称、角色、邮箱、最近登录、创建时间(只读)
界面语言zh-CN / en-US 切换,切换后整页刷新
修改密码当前密码 + 新密码(至少 8 位)+ 确认;成功后清除首次改密标记
API Token个人令牌管理,见下

API Token 用于 CLI / 脚本调用 API:请求头 Authorization: dk_xxx,效力等同登录 JWT。

  1. 点「新建 Token」,填名称(如 local-cli)与有效天数(留空永不过期)。
  2. 创建后弹窗展示明文,仅显示一次,服务端只存哈希,请立即复制保存。
  3. 列表展示前缀、过期时间、最近使用、创建时间;删除后使用该 token 的调用方立即失败。

Token 与 Git 凭据的存储与轮换建议见凭据与 API Token。

相关页面 ​