Files
CLICD/docs/guide/configuration.md
T
MengMengCode 38debab1aa Add custom image handling and access policy management
- Implement tests for custom KVM and LXC image creation, ensuring invalid sources and architecture mismatches are rejected.
- Introduce access policy management in CLI, allowing configuration of allowed sources and trusted proxies.
- Add NAT network configuration with validation for RFC1918 compliance and subnet parsing.
- Create panel access policy management, including normalization and evaluation of access decisions based on client IPs and forwarded headers.
- Develop middleware for enforcing access policies in the server, returning appropriate responses for allowed and denied requests.
- Enhance custom image downloading and validation, ensuring integrity and security of downloaded root filesystem archives.
- Include comprehensive tests for all new functionalities to ensure reliability and correctness.
2026-07-26 04:04:45 +08:00

1.6 KiB

配置说明

CLICD 安装后会以 systemd 服务运行,运行时配置和数据库保存在宿主机本地。实际路径可能随安装脚本参数变化,默认安装建议以 /root/.clicd/ 为主要检查位置。

常见配置项

配置 说明
Web 端口 默认 8999,服务启动时监听 0.0.0.0:8999
管理员账号 用于登录 Web 面板和管理 API Key。
数据库 SQLite,用于保存容器元数据、子用户、审计日志、API Key 等。
NAT 端口范围 用于随机端口和端口映射分配。
IPv6 地址段 宿主机有可路由 IPv6 时可配置分配策略。
安全告警 可配置自动关机等策略。

服务命令

systemctl status clicd
systemctl restart clicd
journalctl -u clicd -n 100 --no-pager

面板访问白名单 CLI

# 查看当前策略
clicd access-policy show

# 仅允许指定 IP/网段;反向代理地址按需填写
clicd access-policy set \
  --allow "203.0.113.10,192.168.1.0/24,2001:db8::/32" \
  --trusted-proxy "127.0.0.1"

# 关闭白名单限制
clicd access-policy disable

也可以运行 clicd cli,在交互菜单中选择“面板访问白名单”。直接命令和交互菜单都会保存配置,并在服务运行时自动重启面板。

安全建议

  • 不要把 Web 面板直接暴露给不可信来源。
  • 使用复杂管理员密码,并定期轮换。
  • API Key 按用途拆分权限,避免长期使用全权限密钥。
  • WebSSH、WebVNC 票据是短期凭证,不应写入日志或外发。
  • 对外文档、截图和工单里不要粘贴真实 IP、密码、API Key 或票据。