配置参考
简体中文 | English
Compose 环境变量
发布产物中的 default.env.example 包含以下变量：
| 变量 | 默认值 | 用途 |
|---|---|---|
IPCHRONICLE_HTTP_PORT | 8080 | 普通 Compose 发布到主机的端口 |
IPCHRONICLE_ADMIN_USERNAME | admin | 首次创建管理员时使用的用户名 |
IPCHRONICLE_ADMIN_PASSWORD | admin | 首次创建管理员时使用的密码 |
CLOUDFLARE_TUNNEL_TOKEN | 空 | Cloudflare Tunnel Compose 使用的 Tunnel token |
启动用户名和密码不会修改已经存在的管理员账户。CLOUDFLARE_TUNNEL_TOKEN 只在 使用 compose.cloudflare-tunnel.yaml 时需要。
Center 镜像环境变量
直接运行 ghcr.io/ipchronicle/ipchronicle-center 或编写自定义 Compose 时，Center 镜像支持以下全部环境变量：
| 变量 | 默认值 | 用途 |
|---|---|---|
IPCHRONICLE_LISTEN_ADDRESS | :8080 | Center HTTP 监听地址 |
IPCHRONICLE_DATA_DIR | /var/lib/ipchronicle | 默认持久数据根目录 |
IPCHRONICLE_CONFIG_DATABASE_PATH | /var/lib/ipchronicle/config/config.db | 配置数据库路径 |
IPCHRONICLE_HISTORY_DATABASE_PATH | /var/lib/ipchronicle/history/history.db | 历史数据库路径 |
IPCHRONICLE_LOGS_DATABASE_PATH | /var/lib/ipchronicle/logs/logs.db | Agent 运维日志数据库路径 |
IPCHRONICLE_MASTER_KEY_PATH | /var/lib/ipchronicle/config/master.key | 凭据加密主密钥路径 |
IPCHRONICLE_ADMIN_USERNAME | admin | 首次创建管理员时使用的用户名 |
IPCHRONICLE_ADMIN_PASSWORD | admin | 首次创建管理员时使用的密码 |
IPCHRONICLE_HEALTHCHECK_URL | http://127.0.0.1:8080/healthz | healthcheck 子命令检查地址 |
持久文件路径必须是绝对路径。设置单独的数据库或主密钥路径时，该值覆盖 IPCHRONICLE_DATA_DIR 派生出的对应默认路径。
系统设置
外部访问地址
自动模式采用管理员当前浏览器的来源地址。自定义模式接受一个 HTTP 或 HTTPS Origin，并用于 Agent 安装命令和通知详情链接。HTTP 可以使用，界面会显示安全提示。
ipapi API Key
完整探测可以选用 ipapi 数据源。未配置 API Key 时，对应字段可能没有数据；其余 数据源不受影响。可以在 ipapi 注册页面 创建账户， 然后在 设置 > 系统 中保存或清除 Key。
Key 在 Center 的 config.db 中加密，只会发送给需要执行探测的 Agent。API 和 Web 界面不会返回已保存的明文值。
公网 IP 发现服务
在 设置 > 网络探测 中分别为 IPv4 和 IPv6 配置 2 到 8 个不同主机的发现 服务。HTTP 和 HTTPS URL 都可使用；HTTP 会显示提示。只有多个服务取得一致结果 时才确认地址。