在国内网络环境下使用 VPS 部署 GitHub 开源项目时，经常会遇到下载速度慢、连接超时、Docker 镜像拉取失败等问题。
本篇教程介绍如何通过 GitHub 加速地址下载 RealmPanel v0.9.5 离线安装包，并使用 Docker 在自己的 VPS 上快速完成安装。
整个过程无需在 VPS 上编译项目源码，适合希望快速部署的用户。
项目地址： https://github.com/xiaofujie369/RealmPanel
官方版本： https://github.com/xiaofujie369/RealmPanel/releases/tag/v0.9.5
一、安装环境要求
本教程主要适用于以下环境：
- Linux VPS（推荐 Debian / Ubuntu）
- 已安装 Docker 和 Docker Compose
- x86_64 / amd64 架构
- root 用户或具备管理员权限
- VPS 有足够空间存放离线安装包和 Docker 镜像
首先检查服务器架构：
uname -m如果显示 x86_64，可以使用本文的 amd64 安装包。
如果显示 aarch64，则需要使用 arm64 镜像包。
检查 Docker：
docker --version
docker compose version如果提示命令不存在，请先安装相应依赖。
注意：以下命令建议逐段执行，每次复制完整命令，不要在命令内部随意插入空行。
二、创建 RealmPanel 安装目录
SSH 登录到 VPS，在 root 终端执行：
mkdir -p /root/RealmPanel-offline && cd /root/RealmPanel-offline该目录用于保存 RealmPanel 的离线安装文件，方便后续检查与部署。
三、使用国内加速地址下载六个安装文件
由于部分 VPS 访问 GitHub Releases 速度较慢，这里使用第三方 GitHub 加速服务下载。
复制以下完整命令执行：
bash -c 'set -e; BASE="https://gh-proxy.org/https://github.com/xiaofujie369/RealmPanel/releases/download/v0.9.5"; for FILE in install.sh install-local.sh realm-panel.tar.gz realm-panel-images-amd64.tar.gz release.json SHA256SUMS; do curl -fL --retry 3 --connect-timeout 15 "$BASE/$FILE" -o "$FILE"; done'安装文件包括：
| 文件 | 说明 |
|---|---|
| install.sh | 安装脚本 |
| install-local.sh | 本地离线安装脚本 |
| realm-panel.tar.gz | 项目安装压缩包 |
| realm-panel-images-amd64.tar.gz | AMD64 预编译 Docker 镜像 |
| release.json | 版本发布信息 |
| SHA256SUMS | 安装文件校验信息 |
下载完成后，可以执行：
ls -lh /root/RealmPanel-offline确认六个文件均已下载。
安全提示： gh-proxy.org 属于第三方加速服务，并非 GitHub 官方域名。正式生产环境建议从官方 GitHub Releases 获取可信校验信息，并核对安装包来源。
四、校验安装包完整性
下载完成后，先不要急着安装。
执行以下命令：
bash /root/RealmPanel-offline/install-local.sh /root/RealmPanel-offline --check如果提示缺少 Python，Debian / Ubuntu 可以执行：
apt-get update && apt-get install -y python3完成后再次执行校验命令。
重要：如果校验失败，请停止安装，不要强行跳过。
可以尝试从官方发布页面重新下载 SHA256SUMS，并通过可信渠道确认校验文件本身的真实性。
注意：如果安装包及校验文件都来自同一个不可信的第三方镜像，即使哈希一致，也不能独立证明安装包未被篡改。
五、执行 RealmPanel 安装
校验通过后，开始安装。
将以下命令中的 你的VPS公网IP 替换为服务器实际公网 IP：
RMP_PUBLIC_IP="你的VPS公网IP" bash /root/RealmPanel-offline/install-local.sh /root/RealmPanel-offline --yes例如，服务器公网 IP 为 203.0.113.10，则命令格式为：
RMP_PUBLIC_IP="203.0.113.10" bash /root/RealmPanel-offline/install-local.sh /root/RealmPanel-offline --yes这里的 IP 仅用于演示，请不要直接复制示例 IP。
安装过程主要使用提前下载的本地镜像和项目文件，不需要重新从 GitHub 拉取应用镜像。
不过，如果系统缺少必要依赖，安装程序仍可能需要连接软件包源。
等待安装脚本执行完成即可。
六、检查 RealmPanel 运行状态
安装完成后，执行：
rmpctl status通过安装脚本提供的管理命令检查项目状态。
也可以查看 Docker 容器：
docker ps如果相关容器没有运行，需要进一步查看容器状态和错误日志。
七、查看 Web 管理后台登录信息
执行：
cat /root/realm-panel-install-info.txt如果安装程序成功生成该文件，终端会显示管理后台访问地址及相关登录信息。
使用显示的完整管理地址、用户名和密码登录即可。
首次登录后，建议立即完成以下安全设置：
- 妥善保存管理员账号和密码
- 使用强密码，避免重复使用其他服务的密码
- 尽量限制管理后台的公网访问来源
- 在云服务器安全组和系统防火墙中，只放行必要端口
- 定期备份配置文件和重要数据
注意：管理端口与转发端口是两个不同概念。管理后台只应允许可信 IP 访问，转发规则所需的 TCP / UDP 端口则根据实际需求开放。
八、下载失败怎么办？
1. GitHub 加速地址无法连接
如果使用 gh-proxy.org 下载失败，可以尝试将第三步命令中的域名替换为：
ghfast.top替代下载地址格式：
https://ghfast.top/https://github.com/xiaofujie369/RealmPanel/releases/download/v0.9.5第三方加速服务的可用性会变化，不能保证任何时候都能正常使用。
2. VPS 使用 ARM64 架构
通过以下命令查看 CPU 架构：
uname -m如果显示：
aarch64则在下载命令中，将：
realm-panel-images-amd64.tar.gz替换成：
realm-panel-images-arm64.tar.gz然后重新下载相应安装包并校验。安装前还需要确认当前版本提供对应的 ARM64 镜像，并且安装脚本支持该架构。
3. Docker 未安装
如果执行：
docker --version显示 command not found，说明 Docker 尚未正确安装或不在当前 PATH 中。
建议先按照 Docker 官方文档完成安装，再继续执行 RealmPanel 部署命令。
Docker 官方网站：
https://docs.docker.com/engine/install
4. 安装完成但后台无法访问
建议依次检查：
- RealmPanel 服务是否正常运行
- Docker 容器是否启动
- 管理后台端口是否监听
- VPS 云平台安全组是否放行对应 TCP 端口
- 系统防火墙是否存在拦截规则
可以使用：
docker ps -a查看所有 Docker 容器。
再使用：
ss -lntup检查当前端口监听状态。
不要为了排查问题直接关闭整台服务器的防火墙，优先针对实际管理端口进行检查。
九、总结
通过 RealmPanel v0.9.5 离线安装包，可以减少 VPS 在部署过程中对 GitHub 实时下载的依赖。
整个安装流程可以概括为：
准备 Docker 环境 → 下载离线安装文件 → 校验安装包 → 执行本地安装 → 查看后台登录信息。
对于网络访问 GitHub 不稳定的 VPS，这种方式可以让部署过程更加方便。
但离线安装并不意味着完全不需要网络，也不代表第三方加速下载天然安全。正式运营时，仍然建议做好安装包可信校验、访问权限控制和数据备份。
相关链接
- GitHub 开源项目：https://github.com/xiaofujie369/RealmPanel
- RealmPanel v0.9.5 发布页：https://github.com/xiaofujie369/RealmPanel/releases/tag/v0.9.5
- Docker 官方文档：https://docs.docker.com/
本文基于 RealmPanel v0.9.5 整理，具体安装行为以该版本实际脚本为准。后续版本可能调整安装参数、文件名或管理命令。
