Linux 部署
使用 APT 或 DNF 安装 WuKongIM，并通过 systemd 启动。
当前 Preview 软件源发布 v3.0.0-beta.8，仅支持 amd64/x86_64。已验证 Ubuntu 24.04、Debian 13、Rocky Linux 9 和 AlmaLinux 9；RHEL 9 可使用同一 EL9 软件源。
Preview 是预发布通道
请先在非生产环境验证，再承载生产流量。
1. 安装
Debian / Ubuntu
curl -fsSL https://packages.githubim.com/repo | sudo sh
sudo apt update
sudo apt install -y wukongimRHEL / Rocky / AlmaLinux 9
curl -fsSL https://packages.githubim.com/repo | sudo sh
sudo dnf -y --disablerepo='*' --enablerepo=wukongim-preview makecache --refresh
sudo dnf install -y wukongim安装后检查版本：
wukongim version软件包会创建服务账号、systemd 服务以及 /etc/wukongim、/var/lib/wukongim 和 /var/log/wukongim，但不会生成配置或启动服务。
2. 初始化配置
sudo wukongim init
# 自动化环境：
sudo wukongim init \
--admin-password-stdin < /secure/path/manager-password保存只显示一次的管理员密码。旧自动化也可继续使用 wukongim config init --config /etc/wukongim/wukongim.toml。然后校验配置：
sudo wukongim config validate --config /etc/wukongim/wukongim.toml默认只监听回环地址。对外开放服务前，请先配置防火墙、TLS 和入口策略。
3. 启动并验证
sudo systemctl enable --now wukongim
curl --fail http://127.0.0.1:5001/readyz/readyz 成功后再接入流量。启动失败时查看日志：
后台管理默认地址是 http://127.0.0.1:5301，使用 admin 和初始化时保存的密码登录。如需公网访问，把配置文件 [manager] 中的 listen_addr 改为 "0.0.0.0:5301"，确认 auth_on = true，重启服务并在防火墙放行 TCP 5301，然后打开 http://<服务器公网IP>:5301。更多说明见 Manager 管理后台。
sudo journalctl -u wukongim -n 100 --no-pager