ARTICLE · 1205107
宝塔面板安装 ZXSORA CMS 最全保姆级教程
宝塔面板安装 ZXSORA CMS最全保姆级教程
从买服务器 → 装宝塔 → 部署上线 → 常见报错全解决
这篇能帮你：哪怕你完全不懂 Linux、没碰过服务器，照着一步步点也能把 ZXSORA CMS 跑起来。
本文包含：① 云服务器去哪买（雨云 + 注册福利）｜② 宝塔怎么装（一行命令）｜③ 部署 ZXSORA CMS 12 步｜④ 超全常见问题 20 条
第一部分：云服务器去哪买（推荐雨云）
装宝塔之前，你得先有一台云服务器。推荐用 雨云（RainYun）——国内云服务器商家，按量计费、价格低、新用户首单有优惠，还提供免费 SSL 证书（3 个月试用期），放 ZXSORA CMS 这种单文件程序很合适。
先领福利：注册链接和邀请码
🔗 注册链接：https://www.rainyun.com/hinoishi_🎫 邀请码（手动填）：hinoishi
通过上面链接/邀请码注册，你能得到什么
| 首月 5 折优惠券 | |
券的具体使用规则以雨云官网为准，领了记得在有效期内用。
买服务器时怎么选（两样东西）
你的名字.com 访问才需要；先用 IP 地址也能跑。 |
✅ 服务器买好、拿到公网 IP 了吗？接下来把它变成能点按钮的管理台——装宝塔。
第二部分：宝塔面板怎么装（最简单最快）
「宝塔」就是一个图形化管理服务器的工具——本来要在黑框里敲命令才能干的事（建网站、传文件、开端口），在宝塔里点几下就行。先把宝塔装上，后面全靠鼠标点。
第 1 步：登录服务器（用 SSH）
在你自己的电脑上，用服务器商家提供的「远程连接」或「SSH 工具」连上服务器。连上后会看到一个黑底白字的命令行窗口，后面所有命令都贴在这里面、按回车。
第 2 步：复制一行命令，回车
CentOS 系统粘贴这句：
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.shUbuntu / Debian 系统粘贴这句：
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh这就相当于在手机上点了一下「安装」，宝塔会自动下载并装好。中间可能会问你 y/n，输入 y 回车即可。等几分钟就好。
第 3 步：记下安装完成后显示的 3 行信息
装完最后会打印出类似这样的内容，务必截图保存：
外网面板地址: http://1.2.3.4:8888/abcdef 用户名: admin 密码: Abc123Xyz
⚠ 注意：宝塔默认地址带一个随机后缀（如 /abcdef），别漏了。如果忘了，服务器上敲 bt 14 能重新显示。
第 4 步：浏览器打开地址，登录
把上面那个 http://1.2.3.4:8888/... 整段复制到电脑浏览器打开 → 输入用户名密码登录。
模拟界面：宝塔登录页
面板地址：http://1.2.3.4:8888/abcdef
用户名：admin
密码：••••••••
登录
第 5 步：首次登录，只装「Nginx」
第一次进宝塔会弹窗问你装什么环境。选 「LNMP 极速安装」或直接只勾 Nginx。ZXSORA CMS 是个独立运行的程序，不依赖 PHP 和数据库，所以其他的都不用装，省时间也省内存。
✅ 装好宝塔 + Nginx，第一部分完成！接下来把 ZXSORA CMS 放上去。
第三部分：把 ZXSORA CMS 部署上线（12 步）
下面每一步都对应宝塔里的一个页面。我们先统一几个「代称」，你换成自己的就行：域名 = 你的网址，如 demo.example.com ｜ 1.2.3.4 = 服务器 IP ｜ 8080 = 程序端口。
① 放行端口（让网站能被访问）
左侧点「安全」→「系统防火墙」→「放行端口」。把 80 和 443 放行（这是网站和 HTTPS 用的）。程序端口 8080 只给服务器自己用，不用对外开。
⚠ 云服务器额外一步：雨云控制台也有「安全组」，同样要把 80、443 放开，否则宝塔里放了也没用。
② 上传 ZXSORA CMS 程序
左侧点「文件」→ 进入 /www/wwwroot/ → 新建文件夹（用你的域名命名）→ 点「上传」，把 ZXSORA CMS 的程序文件传进去。传好后右键程序文件 → 权限 → 勾上「执行」。（下文命令里的 zxsora 就是程序文件名，下载到什么名就换成什么名）
③ 建一个网站
左侧「网站」→「添加站点」。域名填你的（没有就填 IP），PHP 版本选「纯静态」，根目录选刚才建的文件夹。提交。
④ 配置「反向代理」（重点）
用户访问你的域名，先到 Nginx 这个「前台」，再由它把请求转给真正在跑的 ZXSORA CMS 程序。这步就是告诉 Nginx「转到本机 8080 端口」。
在站点设置里点「反向代理」→ 添加，代理名称随便写（如 zxsora），目标 URL 填 http://127.0.0.1:8080，提交。
✅ 关键：在「配置文件」里确认含有这几行（没有就补上再保存），否则后台登录、消息通知会出问题：
proxy_set_header Host $host;proxy_set_header X-Forwarded-Proto $scheme;
⑤ 让程序跑起来
左侧「终端」，进入程序目录先试探性启动一次：
cd /www/wwwroot/demo.example.com ./zxsora看到类似 listening on 127.0.0.1:8080 就说明起来了。先按 Ctrl+C 停掉，下一步让它常驻。
⑥ 设置开机自启 + 崩溃自动重启
让程序在后台乖乖运行，服务器重启也不掉。最稳的办法是建一个系统服务（复制粘贴即可）：
cat > /etc/systemd/system/zxsora.service <<'EOF' [Unit] Description=ZXSORA CMS After=network.target [Service] Type=simple User=www WorkingDirectory=/www/wwwroot/demo.example.com ExecStart=/www/wwwroot/demo.example.com/zxsora Restart=always [Install] WantedBy=multi-user.target EOF systemctl daemon-reload systemctl enable zxsora systemctl start zxsora⑦ 申请 HTTPS 证书（小绿锁）
站点设置里点「SSL」→ 「Let's Encrypt」→ 勾你的域名 → 申请。免费、自动续期。申请完打开「强制 HTTPS」开关（这样 http 会自动跳 https）。
💡 用雨云的小提示：雨云也提供免费 SSL 证书（3 个月试用期），在雨云控制台申请后，把证书内容粘到宝塔站点「SSL」→「其他证书」里就行；不想折腾就直接用宝塔的 Let's Encrypt，同样免费、自动续期。
⑧ 打开网址，完成初始化
浏览器访问你的域名，会出现安装向导：填站点名称、管理员账号密码，点「开始安装」。装完就能进后台了。
🚫 装完后：记得把 /install 这个初始化入口删掉或保护起来，别让别人也能重新装一遍。
（第 ⑨～⑫ 步为细化项：反向代理的高级选项、文件上传大小限制、数据备份、换域名/迁移，详见下方常见问题，均已涵盖。）
🎉 到这一步，网站已经能正常访问了！下面把所有可能踩的坑一次讲清。
第四部分：超全常见问题
1. 浏览器打不开宝塔面板（连不上）
表现：浏览器提示「无法访问此网站」。怎么办：① 确认地址整段复制（含 :8888/随机后缀）；② 云服务器「安全组」和宝塔「系统防火墙」都要放行 8888；③ 服务器是否关机了。
2. 忘记宝塔登录密码
服务器终端里敲 bt 5 回车，按提示输入新密码即可。
3. 忘记宝塔面板地址
终端敲 bt 14，会把地址、用户名、密码重新打印出来。
4. 打开网站显示「502 Bad Gateway」
前台（Nginx）去敲程序门，门没开。最常见原因：程序没在跑。终端敲 systemctl status zxsora 看是不是 running；不是就 systemctl start zxsora。
5. 还是 502，程序明明在跑
检查「反向代理的目标」是不是 127.0.0.1:8080，要和 config 里的端口一致；再确认程序监听的是 127.0.0.1（不是 0.0.0.0 被防火墙挡住）。
6. 网站一片空白 / 只显示文字没样式
多半是静态资源（图片、css）路径不对，或反向代理没把请求完整转给程序。确认反代配置里的 location / 覆盖整站，且保存后点「重载配置」。
7. 后台页面白底白字、看不清（深色模式错乱）
一般是反向代理没把「用户用的是 http 还是 https」告诉程序。在 Nginx 配置加一行 proxy_set_header X-Forwarded-Proto $scheme; 并重载。本仓库另有专门深色适配说明可参考。
8. 浏览器地址栏显示「不安全」
没装 SSL 证书。去站点「SSL」申请 Let's Encrypt 并打开「强制 HTTPS」。装好后地址栏会出现小锁。
9. SSL 证书申请失败
① 域名有没有真的解析到这台服务器（ping 一下你的域名看 IP 对不对）；② 防火墙/安全组 80 端口是否放开（验证要用 80）；③ 域名没备案（国内服务器要求备案）。
10. 服务器重启后网站打不开了
程序没设开机自启。终端执行 systemctl enable zxsora，下次重启会自动起来。
11. 上传头像/附件提示过大被拦
宝塔默认限制上传大小。站点设置 → 配置 → 找到上传限制，把 client_max_body_size 调大（如 50m），保存重载。
12. 网站访问很慢
① 服务器配置太低（2G 内存以下建议升级）；② 没开缓存；③ 图片太大没压缩。先试把程序重启、清理浏览器缓存再看。
13. 后台登录不上去 / 一直跳回登录页
多半是第 ④ 步漏了 X-Forwarded-Proto 头，导致程序以为每次都是新会话。补上并重载 Nginx。也试试清 Cookie。
14. 图片/头像传了不显示
检查上传目录（data）有没有写权限；程序用户是 www，目录属主最好也设成 www。或确认反向代理没有把静态文件路径拦截。
15. 域名解析了但还访问不了
DNS 生效要等几分钟到几小时；用手机流量（别用同一 WiFi）访问试试，排除本地缓存。ping 域名看 IP 是否等于服务器公网 IP。
16. 怎么升级 ZXSORA CMS 到新版本
终端：systemctl stop zxsora → 把新程序文件覆盖旧的（保留 config 和 data 文件夹）→ systemctl start zxsora。因为前端已打包进程序，不用单独更前端。
17. 怎么备份，防止数据丢了
宝塔「计划任务」→ 选「目录备份」→ 把 /www/wwwroot/你的目录 整个打包，设每天自动备份到本地或云存储。程序是单文件，连同 data 一起备最省心。
18. 想换个域名 / 把站搬到别的服务器
换域名：宝塔里给站点「添加域名」、改 config 里的 domain，重新申请证书即可。搬家：把整个目录打包传到新服务器，按本文 12 步重做一遍反代和自启。
19. 手机上看排版乱
ZXSORA CMS 本身是响应式的。若乱，多是浏览器缓存了旧版，清缓存/强刷（Ctrl+F5）再看；或确认程序是最新版。
20. 网站被攻击 / 流量异常暴增
宝塔「系统防火墙」可设访问频率限制；必要时在雨云后台开启「DDoS 防护」或给面板换非常用端口并限制登录 IP。
照着做还搞不定？把报错的截图发出来，我帮你逐条定位 👋
