XG-LiunxPanel 安装 / 管理 / 卸载教程

本教程使用安装脚本 xg_panel_install.sh，脚本会自动下载并安装面板，注册为 systemd 服务。

一键安装（推荐）

root 下执行一条命令，下载、安装、启动一次完成：

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh install --port 8090 --entrance xgpanel
  • --port 8090：面板端口，可改成 8899 等；
  • --entrance xgpanel：安全入口，安装完成后访问 http://服务器IP:8090/xgpanel；不写则使用根路径 http://服务器IP:8090/；
  • 安装结束会打印实际访问地址、默认账号和密码。

想用默认端口 + 根路径，可用最短的一行：

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh

脚本已是自解压的加密版本，下载后直接 bash 即可，无需 chmod。

一、环境要求

项目 要求
系统 使用 systemd 的 Linux 发行版（CentOS 7+ / Debian / Ubuntu / Rocky / Alma 等）
架构 amd64 / 386 / arm / arm64（脚本自动识别）
权限 root
依赖 curl 或 wget（脚本会自动选择）
端口 默认 8090/tcp，可在云服务器安全组放行

检查架构：

uname -m

脚本按 uname -m 自动选择安装包，对应关系：

uname -m 输出 安装包
x86_64 / amd64 xg_panel_linux_amd64
i386 / i686 xg_panel_linux_386
armv7l / armv6l / arm xg_panel_linux_arm
aarch64 / arm64 xg_panel_linux_arm64

下载地址统一为 https://blog.itxiaoguo.xyz/ 加上对应的二进制文件名，例如 https://blog.itxiaoguo.xyz/xg_panel_linux_amd64、https://blog.itxiaoguo.xyz/xg_panel_linux_386，无需手动指定，脚本会自动拼接。

二、获取安装脚本

方式一：服务器直接下载（推荐）

curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh
chmod +x /root/xg_panel_install.sh

没有 curl 时可用 wget：
wget -O /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh

方式二：本机上传（在本地电脑执行，把 IP 换成你的服务器）

scp xg_panel_install.sh root@你的服务器IP:/root/

方式三：服务器上直接创建

vi /root/xg_panel_install.sh
# 粘贴脚本内容，保存退出后执行：
chmod +x /root/xg_panel_install.sh

脚本下载地址：https://blog.itxiaoguo.xyz/xg_panel_install.sh

三、安装

1. 默认端口安装

sudo bash /root/xg_panel_install.sh

2. 指定端口安装

sudo bash /root/xg_panel_install.sh install --port 8899

3. 指定端口 + 安全入口安装

sudo bash /root/xg_panel_install.sh install --port 8899 --entrance xgpanel
  • --entrance 只能包含字母、数字、下划线、短横线，长度 3–32 位；
  • 安装完成后访问 http://服务器IP:8899/xgpanel，不知道入口无法打开面板；
  • 不写 --entrance 时使用根路径 http://服务器IP:8899/。

脚本执行流程：

  1. 校验 root 权限、CPU 架构（自动匹配 amd64 / 386 / arm / arm64）、systemd；
  2. 按架构下载面板程序（如 https://blog.itxiaoguo.xyz/xg_panel_linux_amd64）并校验是否为 ELF 可执行文件；
  3. 安装到 /opt/xg-liunxpanel/xg-panel；
  4. 写入服务 /etc/systemd/system/xg-panel.service 并设置开机自启；
  5. 启动服务并校验运行状态；
  6. 指定了 --entrance 时，写入 panel.conf 的 entrance= 并重启服务使之生效；
  7. 自动放行 firewalld / ufw 端口；
  8. 打印面板地址、默认账号与数据目录。

4. 安装完成后的输出示例

[XG] XG-LiunxPanel 安装完成并已启动
[XG] 已设置安全入口：/xgpanel

  面板地址：http://1.2.3.4:8090/xgpanel
  默认账号：admin
  默认密码：admin123（登录后请立即修改）
  数据目录：/opt/xg-linux
  服务管理：systemctl {status|restart|stop} xg-panel

未设置安全入口时，面板地址显示为 http://1.2.3.4:8090/。

5. 首次登录

浏览器打开输出的面板地址（http://服务器IP:端口/入口），使用 admin / admin123 登录，登录后立即在「设置」中修改密码。

打不开时先检查：安全组是否放行端口 → systemctl status xg-panel → 本机 curl -I http://127.0.0.1:8090。

四、日常管理

1. 查看运行状态

bash /root/xg_panel_install.sh status

输出服务名称、运行状态、程序路径、数据目录、安全入口、访问地址。

2. 常用服务命令

systemctl status xg-panel     # 查看状态
systemctl restart xg-panel    # 重启
systemctl stop xg-panel       # 停止
systemctl start xg-panel      # 启动
systemctl enable xg-panel     # 开机自启
systemctl disable xg-panel    # 取消开机自启

3. 查看日志

journalctl -u xg-panel -n 100 --no-pager      # 最近 100 行
journalctl -u xg-panel -f                     # 实时跟踪

后台安装类任务的日志在面板「任务日志」页面查看，文件位于面板数据目录下。

4. 修改端口

方式一：重新执行安装并指定端口（程序会保留数据）

sudo bash /root/xg_panel_install.sh install --port 8899

方式二：修改配置文件后重启

sed -i 's/^port=.*/port=8899/' /opt/xg-linux/panel.conf
systemctl restart xg-panel

修改后记得在防火墙 / 云安全组放行新端口。

5. 修改安全入口

sed -i 's/^entrance=.*/entrance=myentry/' /opt/xg-linux/panel.conf
systemctl restart xg-panel
  • 入口只能包含字母、数字、下划线、短横线，长度 3–32 位；
  • 修改后访问 http://服务器IP:端口/myentry，旧入口立即失效；
  • 也可以在面板「设置」页面修改，保存后按提示重启服务。

想把入口改回根路径，把该行改成 entrance=（留空）后重启即可。

6. 目录说明

路径 说明
/opt/xg-liunxpanel/xg-panel 面板主程序
/etc/systemd/system/xg-panel.service systemd 服务文件
/opt/xg-linux/ 面板数据目录（配置、站点表、日志等）
/opt/xg-linux/panel.conf 面板监听端口、安全入口、标题等基础配置
/www/ 网站、数据库、运行环境等业务目录

五、更新

sudo bash /root/xg_panel_install.sh update

更新流程：下载新版本 → 备份旧程序为 xg-panel.bak → 停止服务 → 替换程序 → 启动。

如果新版本启动失败，脚本会自动回滚到旧版本并提示查看日志：

journalctl -u xg-panel -n 50 --no-pager

回滚完成后旧程序仍在 /opt/xg-liunxpanel/xg-panel.bak，可手动用于排查。

六、卸载

1. 保留数据卸载（推荐）

sudo bash /root/xg_panel_install.sh uninstall

会停止并删除服务、删除程序目录 /opt/xg-liunxpanel，保留 /opt/xg-linux 中的数据。

2. 彻底卸载（含数据）

sudo bash /root/xg_panel_install.sh uninstall --purge

在上一项基础上再删除 /opt/xg-linux 面板数据。

注意：--purge 只删除面板自身的数据目录。/www 下已创建的网站、数据库、运行环境不会被删除，需要自行清理。

3. 卸载后确认

systemctl status xg-panel        # 应提示 Unit xg-panel.service could not be found
ls /opt/xg-liunxpanel            # 应提示 No such file or directory

七、常见问题

1. 提示 请使用 root 运行

脚本需要 root 权限，使用 sudo bash xg_panel_install.sh ... 执行。

2. 提示 当前架构 xxx 不受支持，仅提供 amd64 / 386 / arm / arm64 安装包

说明 uname -m 的输出不属于下面任一类：x86_64、i386、i686、armv7l、aarch64 等。可先确认架构，再到下载页取对应文件，用 --bin 指定本地文件安装。

3. 提示 下载失败，请检查网络或地址

检查服务器能否访问外网，或先手动验证下载地址（把 amd64 换成实际架构）：

uname -m
curl -I https://blog.itxiaoguo.xyz/xg_panel_linux_amd64

4. 提示 下载失败（HTTP 错误或网络不通） 或 下载内容不是 ELF 可执行文件

先用 curl -I 下载地址 看返回码。若是 404 Not Found，说明这个地址上并没有文件（常见于博客/CDN 把上传文件改成了 /content/uploadfile/... 的随机名）。两种解法：

# 改用真实地址
sudo bash /root/xg_panel_install.sh install --url https://你的真实地址/xg_panel_linux_amd64

# 或先把程序文件上传到服务器，再指定本地文件安装
sudo bash /root/xg_panel_install.sh install --bin /root/xg_panel_linux_amd64

5. 服务启动失败

journalctl -u xg-panel -n 80 --no-pager

常见原因：端口被占用（ss -lnt | grep 8090）、程序无执行权限、磁盘已满。

6. 面板打不开但服务是 active

  • 云服务器安全组未放行端口；
  • 本机 firewalld / ufw 未放行：脚本会自动尝试，若之前手动关闭过防火墙则需重新放行；
  • 浏览器访问的是 https，而面板默认是 http。

7. 忘记登录密码

账号密码保存在 /opt/xg-linux/panel.conf（pass 为哈希值，无法手改）。可删除该配置文件让面板重建默认账号：

systemctl stop xg-panel
cp /opt/xg-linux/panel.conf /opt/xg-linux/panel.conf.bak
rm -f /opt/xg-linux/panel.conf
systemctl start xg-panel

重启后面板会生成新的默认配置，账号恢复为 admin / admin123、端口回到 8090；如需保留原端口，对比备份文件再把 port= 改回去并重启。

8. 设置安全入口后打不开面板

安全入口必须带在地址后面，例如入口为 xgpanel、端口为 8090 时，访问 http://服务器IP:8090/xgpanel。只访问 http://服务器IP:8090/ 会被拒绝，这是正常的安全设计。

忘记入口时执行 bash /root/xg_panel_install.sh status 查看，或直接看配置：

grep '^entrance=' /opt/xg-linux/panel.conf

八、命令速查

# 一键安装（下载 + 安装 + 启动）
curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh && bash /root/xg_panel_install.sh

# 下载脚本
curl -fL -o /root/xg_panel_install.sh https://blog.itxiaoguo.xyz/xg_panel_install.sh

# 安装
sudo bash /root/xg_panel_install.sh
sudo bash /root/xg_panel_install.sh install --port 8899
sudo bash /root/xg_panel_install.sh install --port 8899 --entrance xgpanel

# 状态
bash /root/xg_panel_install.sh status

# 更新
sudo bash /root/xg_panel_install.sh update

# 卸载
sudo bash /root/xg_panel_install.sh uninstall
sudo bash /root/xg_panel_install.sh uninstall --purge

# 服务
systemctl {status|restart|stop|start} xg-panel
journalctl -u xg-panel -n 100 --no-pager