跳转至

系统设置

常规实例配置在 系统设置 中管理,保存后立即生效并随数据库备份,不需要编辑数据库或 .env。来源筛选与执行策略分别见追踪器和执行器。

全局配置

设置 默认值 / 范围 影响
BASE URL 空;非空时必须为规范的绝对 HTTPS URL 通知链接、前端基础路径、OIDC 回调和仓库 Webhook 接收地址;包含部署子路径
时区 UTC;有效 IANA 时区,如 Asia/Shanghai 日期展示、维护窗口和通知消息中的时间
日志级别 INFO;DEBUG/INFO/WARNING/ERROR 后端日志详细程度
OCI 镜像仓库跳转 关闭 仅在镜像仓库需要跳转访问时开启;跳转仍受安全校验约束
就绪观察默认值 见健康检查 执行器未单独覆盖时使用
发布渠道版本历史 20;1–1000 每个发布渠道保留的版本记录数
执行器运行态快照 10;1–1000 每个执行器保留的快照数;锁定或占用中的快照受保护,实际数量可能更多
系统备份保留份数 7;1–100 数据目录 backups 下保留的全量备份数
系统自动备份周期 0(关闭);0–8760 小时 自动全量备份间隔,见在线备份

版本历史和快照可点击 立即清理 按当前数量裁剪;版本历史也会在每天 02:00 或维护窗口结束后自动清理。调小数量前确认需要保留的记录,清理不能代替备份。代理配置见反向代理与子路径,密钥轮换见备份、升级与密钥。

运行时操作策略(API)

通过运行时连接 API 的 config.operation_policy 配置,暂无专用表单。以下为 config 片段,编辑时保留其他配置键:

{
  "operation_policy": {
    "read_timeout_seconds": 20,
    "write_timeout_seconds": 90,
    "read_retries": 1
  }
}
字段 默认值 合法范围(整数)
read_timeout_seconds 20 秒 1–600
write_timeout_seconds 90 秒 1–600
read_retries 1 次额外重试 0–3;0 表示不重试
调用路径 策略应用方式
Portainer 读取 读取超时,瞬态传输失败有限重试
Portainer Stack 写入 写请求超时,不自动重放
Docker / Podman SDK 客户端网络超时使用写超时值
Compose / Helm 命令 子进程使用写操作预算,不自动重放
Kubernetes 原生工作负载 API 尚未统一接入

这不是整个更新流程的总时限。写请求超时后服务端仍可能已执行更新,见更新超时。