主题
系统设置
四个 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 全局最大并发运行数 | 5 | 1-200;超出的新运行进入 queued 排队 |
| logRetentionDays 日志保留天数 | 30 | 0 表示不自动清理 |
| logMaxBytes 单条日志大小上限(字节) | 104857600(100 MiB) | 最小 1024,超出后截断并提示 |
| hookRateLimitPerMinute Hook 每分钟限流 | 60 | 单 Token 每分钟最大触发次数 |
| visibility 项目可见性 | allReadable | allReadable 其他登录用户只读可见 / 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 私钥)、用户名、创建时间。
- 新建:选类型后填字段——HTTPS Token 需用户名 + Token;SSH 私钥的用户名可选 (默认 git),粘贴私钥内容,可另填 passphrase。
- 编辑:密文字段留空表示保持原值不变。
- 连接测试:在编辑弹窗内点「测试连接」,填仓库地址与可选分支, 服务端执行
git ls-remote验证连通性与认证。 - 删除:被项目引用时服务端拒绝删除并提示。
密文加密存储、只在服务端使用,详见凭据与 API Token。
服务器 SSH 公钥卡片:展示服务端自身 ~/.ssh 下的公钥(与数据库凭据是两回事), 含类型、路径、指纹与一键复制。生成密钥(仅 admin):
- 选择类型:ed25519 或 rsa(4096 位)。
- 点「生成 SSH 密钥」并确认;同类型密钥已存在时按钮置灰,不会覆盖。
- 复制公钥添加到 Git 平台(Deploy Key / 账号 SSH Key),即可用 SSH 地址拉取私有仓库。
个人设置(profile)
| 卡片 | 内容 |
|---|---|
| 账号信息 | 用户名、昵称、角色、邮箱、最近登录、创建时间(只读) |
| 界面语言 | zh-CN / en-US 切换,切换后整页刷新 |
| 修改密码 | 当前密码 + 新密码(至少 8 位)+ 确认;成功后清除首次改密标记 |
| API Token | 个人令牌管理,见下 |
API Token 用于 CLI / 脚本调用 API:请求头 Authorization: dk_xxx,效力等同登录 JWT。
- 点「新建 Token」,填名称(如 local-cli)与有效天数(留空永不过期)。
- 创建后弹窗展示明文,仅显示一次,服务端只存哈希,请立即复制保存。
- 列表展示前缀、过期时间、最近使用、创建时间;删除后使用该 token 的调用方立即失败。
Token 与 Git 凭据的存储与轮换建议见凭据与 API Token。