1Panel 面板安装部署与避坑笔记

如果你厌倦了传统运维面板在宿主机里硬装一堆依赖、卸载还留下大量残留文件的做法，基于现代化 Docker 架构的 1Panel 是目前 Linux 服务器上非常清爽的替代品。

所有组件（Nginx/OpenResty、MySQL、Redis）全都容器化隔离，升级和备份非常透明。

不过在安装和日常使用时，有几个常见的坑需要提前避开：比如宿主机原有的 80/443 端口冲突、小内存机器没配限制导致容器挤占内存，以及数据备份目录的规划。

这里记录 1Panel 的官方安装流程、初始配置与核心避坑要点。

为什么选择 1Panel 现代运维面板

过去很多人习惯用传统宝塔面板，但在现代云原生环境下，1Panel（基于 Go 语言 + Docker 开发） 展现出了碾压级的架构优势：

【传统面板 vs 1Panel 现代化运维对比】

┌─────────────────────────────────────────────────────────────┐
│ 🔴 传统面板：侵入式深度绑定                                   │
│    - 直接往你系统底层编译安装各种库，卸载后残留满地垃圾；     │
│    - 绑定手机号、强制登录商业账号，后台常驻各种监控探针吃内存； │
│    - 一旦面板崩了，底下挂着的网站跟着一起死。                 │
├─────────────────────────────────────────────────────────────┤
│ 🟢 1Panel：纯净容器化（零污染）                             │
│    - 所有应用（网站、数据库、网盘）全部以标准 Docker 容器运行； │
│    - 面板与底层系统彻底解耦，面板关掉，容器业务依然正常飞驰； │
│    - 零广告、开源无限制、全端自适应手机管理，1.6G 小机极速秒开！ │
└─────────────────────────────────────────────────────────────┘

系统要求与前置检查

• [ ] 一台 Linux 云服务器（VPS）：全新安装的 Debian 12 或 Ubuntu 22.04/24.04 体验最佳；
• [ ] 拥有 root 登录权限：通过本地终端连入黑色命令行窗口；
• [ ] 想好一个自定义面板端口：默认是随机生成的五位高位端口（如 25890），也可以自己指定；
• [ ] 云控制台安全组前置意识：在云平台网页控制台，准备随时放行该面板端口。

执行官方脚本安装 1Panel

💻 【你本地的电脑】 打开终端连接服务器，进入 服务器端：。

整段复制并粘贴执行 1Panel 官方通用一键安装脚本：

# 1. 刷新环境依赖并执行官方一键安装
export DEBIAN_FRONTEND=noninteractive
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

• 🗣️ 说明：安装脚本运行中途，屏幕会弹出几个提问，直接一路按回车使用默认推荐配置即可：
  1. 设置 1Panel 安装目录 👉 直接按回车（默认 /opt）；
  2. 设置 1Panel 端口 👉 直接按回车（或输入你想好的自定义高位端口）；
  3. 设置 1Panel 安全入口 👉 直接按回车（或输入你习惯的英文代号，例如 admin）；
  4. 设置 1Panel 用户名与密码 👉 按照提示输入你自己设定的密码（输密码不显字，只管敲完按回车）。

脚本跑完后，终端最后会打印出一段极其关键的信息：

==================================================
1Panel 服务正在运行中...
外网访问地址: http://123.45.67.89:25890/xxxxxx
内网访问地址: http://10.0.0.1:25890/xxxxxx
面板用户: admin
面板密码: 你的密码
==================================================

⚠️ 关键动作：立刻用鼠标完整选中这段信息，复制并保存在你本地电脑的便签或密码库中！

放行面板安全访问端口

为什么很多新手在终端里装完，在浏览器打开上面的外网地址却一直提示“连接超时”？
因为服务器外部的云厂商防火墙（安全组）把这个高位端口给挡住了！

💻 【你本地的浏览器】 打开购买 VPS 的云服务商控制台（腾讯云/阿里云/AWS/华为云等）：

1. 进入服务器实例详情页，点击 「安全组」 或 「防火墙」 标签；
2. 点击 「添加入站规则」：
   * 协议类型：选择 TCP；
   * 端口范围：填入刚才安装时分配的面板端口号（例如 25890）；
   * 授权源 / IP：填 0.0.0.0/0；
   * 策略：允许；
3. 顺便放行网页标准端口：80 和 443（后续建站和反代必用）；
4. 点击保存。

• ✅ 成功标志：安全组列表中清晰看到你的面板端口与 80/443 端口均处于放行状态。

首次登录面板与安全初始化

💻 【你本地的浏览器】 打开刚才保存的完整外网访问地址：

http://你的服务器IP:面板端口/你的安全入口

⚠️ 注意：末尾的 /安全入口 绝对不能漏！这是防全网黑客暴力扫描的第一道防线。如果不加入口，浏览器会显示 404 或拦截。

输入刚才设置的用户名和密码，点击登录：

• ✅ 成功标志：跃入极其现代化、清爽舒适的 1Panel 首页仪表盘！CPU、内存、磁盘负载、Docker 运行状态一目了然。

安装与初期运维的关键避坑点

进入面板后，千万不要一通乱点！先记住这三个最核心的生产避坑铁律：

避坑：OpenResty 与宿主机现有 Nginx 端口冲突

在 1Panel 左侧菜单的 「网站」 里，它会提示你安装 OpenResty 容器来负责反向代理和建站。

• 如果你的服务器是全新裸机：
  👉 放心在 1Panel 里直接点击安装 OpenResty，它会作为 Docker 容器接管 80/443 端口，后续图形化申请证书、反代网站全在这个容器里搞定，极其丝滑；
• 如果你的服务器之前已经通过 apt install nginx 装了系统级 Nginx：
  👉 千万不要再在 1Panel 里重复装 OpenResty！ 否则两个服务同时抢占 80 端口，OpenResty 会反复报错无法启动。二者只能留其一。

小内存 VPS 容器资源控制与限制

如果你的 VPS 内存只有 1GB ~ 2GB，请遵守以下原则：
1. 不要安装沉重的独立 MySQL 容器：很多轻量程序（如 Halo、SQLite 项目）优先使用嵌入式文件数据库，不需要额外启动吃 600MB 内存的 MySQL 容器；
2. 关闭非必要监控进程：如果日常负载很轻，不需要在面板里开启过于频繁的秒级指标采集；
3. 结合 Swap 应急内存垫底：确保服务器拥有 1G~2G 的 Swap 交换分区，防止突发构建时被系统 OOM 强行把面板杀掉。

容器持久化目录规划与备份

在 1Panel 应用商店安装的任何容器（Halo、AList、WordPress 等），其数据默认全部保存在宿主机的：

/opt/1panel/apps/应用名称/

• 大白话：不要害怕容器被删！只要 /opt/1panel/apps/ 下的文件还在，重新拉起容器数据完好无损。
• 一键备份：在 1Panel 左侧菜单找到 「计划任务」，可以设置每周把这个目录打包并自动推送到异地网盘（Google Drive/S3/WebDAV），彻底实现高枕无忧。

为 1Panel 面板本身绑定域名与 SSL 证书

有了 1Panel，给你的 Docker 服务绑域名变得傻瓜级简单：

1. 确保域名 A 记录已解析到服务器公网 IP；
2. 在 1Panel 左侧点击 「网站」➔「创建网站」；
3. 选择 「反向代理」：
   * 主域名：填入你的域名（例如 pan.example.com）；
   * 代理地址：填入内部服务地址（例如 http://127.0.0.1:5244）；
4. 点击创建；
5. 进入该网站详情，点击 「HTTPS」 标签，选择 「一键申请证书（ACME / Let’s Encrypt）」：
   * 勾选「自动续期」；
   * 点击确认申请！

不到 10 秒钟，一个自带 HTTPS 绿锁、自动续期、全球秒开的现代化反代站点就建好了！

1Panel 常用 1pctl 命令行工具速查

万一哪天不小心把访问地址忘了，或者面板打不开了怎么办？记住这个万能指令：1pctl！

服务器端： 常用救命命令速查：