1Panel 应用

适合已经在用 1Panel v2 面板的服务器。本页按 1Panel 中文版 v2.3.2 的界面编写，全程在 1Panel 网页里完成，不需要登录服务器终端。

说明

1Panel 方式需要的离线镜像文件会随首个正式版本一起发布；届时本页会按实际界面再核对一遍。

开始前请确认准备工作里的域名解析和 80/443 端口都办好了，并下载好两个文件：

• onepanel-cms-<版本>.zip：1Panel 本地应用包
• cms-image-<版本>-linux-amd64.tar：程序的离线镜像

第 1 步：装好数据库和 OpenResty

在 1Panel「应用商店」里装好：

• 数据库：MySQL 8.0、MySQL 8.4 或 MariaDB 10.6 及以上，任选一个（用 MySQL 8.0 也可以，后台会提醒它已经停止维护）；
• OpenResty。

已经装过的跳过。

第 2 步：上传应用包和镜像

1. 在「文件」里上传 onepanel-cms-<版本>.zip，解压到 /opt/1panel/resource/apps/local/。解压后那里会多出一个 cms 目录。
2. 在「文件」里上传 cms-image-<版本>-linux-amd64.tar，放在任意目录。
3. 打开「容器 → 镜像 → 导入镜像」，点路径框左边的文件夹图标，选中刚上传的镜像文件，再点导入。

一定要点文件夹图标

在 v2.3.2 里只手动输入文件路径，点「导入」可能没有反应。请用文件夹图标去选文件。

第 3 步：安装应用

1. 打开「应用商店」，点「同步本地应用」，在「本地」分类里找到本应用，点「安装」。
2. 填写安装表单：
   • 数据库服务：选第 1 步装好的数据库。库名、数据库账号和口令由 1Panel 自动生成，不用改。
   • 网站域名：填你的域名，只填域名，不带 http://。
   • 管理员名：默认 admin。
   • 管理员口令：1Panel 会随机生成一个。请记下来；装好后也可以在该应用的「参数」里查看。
3. 取消勾选「拉取镜像」，再点确认。

安装即表示你已阅读并同意应用目录里的 LICENSE.txt（用户许可协议）。

为什么要取消「拉取镜像」

它默认是勾着的。本程序的镜像是你刚才导入的离线镜像，不在任何镜像仓库里；1Panel 如果去仓库拉，就会失败。

管理员口令只在第一次有效

表单里的管理员口令只用来创建管理员。装好以后再在 1Panel 里改这个参数，不会改变后台口令。忘了口令请看找回管理员口令。

第 4 步：创建网站

打开「网站 → 创建网站 → 一键部署」，选择刚装好的本应用，域名填同一个。

第 5 步：申请证书，开启 HTTPS

1Panel 安装时已经自带一个 Let's Encrypt 账户，不用另外注册。

1. 打开「网站 → 证书 → 申请证书」。「从网站中获取」选本站，验证方式选 HTTP，申请。
2. 打开该网站的「配置 → HTTPS」，打开「启用 HTTPS」；「Acme 账户」选已有的账户，「证书」选刚签好的证书，保存。默认会把 HTTP 访问自动跳到 HTTPS。

现在打开 https://你的域名/ 和 https://你的域名/admin/：第一个网站和管理员已经自动建好，用表单里的管理员名和口令登录即可。

给网站加更多域名

先在本程序后台给站点添加域名，并把新域名解析到服务器（仅 DNS）。然后回到 1Panel：

1. 打开该网站的「域名设置」，添加同一个域名；
2. 在「证书」里编辑本站的证书，把新域名加到「其他域名」里；
3. 点该证书的「申请」。重新签好后，1Panel 会自动同步到网站上。

后台添加域名时也会提醒你做这几步。

装好以后的备份、升级等，见日常维护。