- 首页
- 开始使用
- 安装部署
安装部署
准备
- 系统：Windows 7+ / Linux（内核 3.10+），64 位；
- 内存：≥512MB 可用（软件自身占用约 20~50MB）；
- 依赖：无需运行时；防火墙封禁依赖系统
iptables/nft（Linux）或netsh（Windows）。
| 平台 | 权限 | 额外要求 |
|---|---|---|
| Windows | 管理员（防火墙规则需 netsh） | 无；MySQL 备份功能需另外安装 MySQL 客户端（mysqldump） |
| Linux | root（iptables / nft） | 同上 |
构建时禁止
-ldflags "-s -w" 或 UPX 压缩：自检模块依赖符号信息，压缩会显著提高杀毒软件误报率。⚠️ 升级提示：从 v1.0.0 升级到 v1.1.0 后，API 与面板已合并为单端口 529，原 5290 面板端口不再监听；首次运行新版时请清除浏览器中旧面板端口的书签，并重新登录。
获取 / 构建程序
方式一：直接下载预编译二进制（推荐）
- 产物与仓库源码
go build输出完全一致（未做 Strip / UPX 压缩，保证自检模块与低误报率）。 - Linux 版下载后需赋予执行权限：
chmod +x qidun。 - 下载完成后继续下方「初始化管理员」步骤。
方式二：从源码构建
# Windows 产物
go build -o bin/qidun.exe .
# Linux 产物（纯静态，无 cgo）
$env:CGO_ENABLED=0; go build -o bin/qidun .
- 仓库内已包含全部依赖与内嵌前端资源，克隆后直接构建。
- 测试：
go test ./...（约 50 用例）。
初始化管理员
# Windows
.\qidun.exe init
# Linux
sudo ./qidun init
# 输出示例：
已初始化管理员账号 admin，初始密码: XxxXxxXxXxXxXxXx
- 账号固定为
admin，初始密码为 16 位随机串（剔除易混淆字符）。 - 幂等：已初始化则提示已存在；未修改过的初始密码可用
qidun user show再次查看。 - 数据目录默认 Windows
C:\ProgramData\Qidun、Linux/var/lib/qidun；可用--data-dir指定。
注册系统服务（推荐）
# Windows（管理员 PowerShell / CMD）
.\qidun.exe service install
# Linux
sudo ./qidun service install
sudo systemctl enable qidun-main qidun-guard # 开机自启
# 查看状态 / 启停
.\qidun.exe service status
.\qidun.exe service stop # 停主服务（guard 仍运行）
.\qidun.exe service stop guard # 停守卫
- 一次注册两个服务：
qidun-main（529 面板 + 全部模块）与qidun-guard（530 守卫 + 蜜罐），并立即启动。 - Windows：注册为自动启动服务，并配置 SCM 故障恢复（异常退出按 5s / 10s / 30s 自动重启）。
- Linux：写入 systemd unit（
Restart=always, RestartSec=5），需手动systemctl enable。 - 幂等：重复执行安全（先停旧卸载再重装），也是升级的标准动作。
- MySQL 备份需在运行 Qidun 的机器上安装 MySQL 客户端（
mysqldump在 PATH 中）。
前台运行（临时调试）
# Windows
.\qidun.exe run --role main --data-dir D:\qidun\data
.\qidun.exe run --role guard --data-dir D:\qidun\data
# 或使用仓库自带脚本：
.\scripts\start.ps1 -Action start -DataDir .\data -SvcPort 529 -GuardPort 530
# Linux
sudo ./qidun run --role main --data-dir /var/lib/qidun
sudo ./qidun run --role guard --data-dir /var/lib/qidun
验证安装
qidun service status— 两个服务均为 running。- 检查端口监听：
netstat -ano | findstr "529 530"（Linux：ss -lntp | grep -E '529|530'）。 - 本机日志无报错：
<数据目录>\logs\qidun-main.log应出现[server] Qidun v1.2.17 HTTPS (api+panel) on https://0.0.0.0:529。 - 在管理电脑上完成证书导入（见下一页证书与首次登录）后浏览器访问
https://<服务器IP>:529。
卸载
.\qidun.exe service uninstall # 卸载两个服务（先停后删）
.\qidun.exe service uninstall guard # 只卸守卫
务必用
service uninstall 卸载；手动 sc delete 后进程不会退出，需 taskkill /f /im qidun.exe 清理。数据目录（数据库 / 证书 / 日志 / 备份）不会被删除，需要时手动清理。下一步：证书与首次登录 — 浏览器导入 mTLS 证书并首次登录面板。
Qidun 启盾 v1.2.17 · 离线静态文档 · 界面基于 KuoqiUI · 返回首页