1Panel 安装教程:给 VPS 装上可视化管理面板,从登录到首次设置

买了一台 VPS,很多人第一反应是装宝塔;如果你更想用一个开源、以 Docker 为基础的面板,1Panel 也是个很顺手的选择。
它把网站、数据库、Docker 容器、文件、计划任务和服务器状态放进同一个后台。
以后装 WordPress、跑 Node.js 或 Python 项目,不用每次都从命令行开始找配置文件。

先说结论:什么人适合装 1Panel

如果你的 VPS 是空的,想拿来建站、跑几个自托管应用,或者以后部署自己的 PHP、Node.js、Python 项目,直接装就行。

1Panel 不会替代 Linux,也不要求你把 Linux 学成运维工程师。它更像是把那些总会用到、但不想每次都手敲的操作收进了一个后台:看容器、改文件、建数据库、申请证书、查日志,都在网页里完成。

它不太适合的情况也简单:这台机器已经有别的面板,或者正跑着一套自己维护的 Nginx、Docker 和网站。别为了试试就往上叠装面板,容易把现有服务弄乱。新开的空机没有这个顾虑。

安装前只看三件事

空机安装不用先做一长串体检。官方的在线安装要求很直接:系统是主流 Linux、服务器能访问互联网,且建议可用内存至少 1GB。

你只需要确认下面三件事:

  • 系统是 Debian、Ubuntu、CentOS、Rocky Linux、AlmaLinux 一类常见 Linux;
  • VPS 能正常联网;
  • 内存别太小。1GB 能把面板装起来,但想再跑网站和数据库,2GB 会更从容。

想看一下系统版本,可以执行:

cat /etc/os-release

到这里就够了。安装脚本会识别 CPU 架构、下载对应版本并校验安装包;没必要在空机上为了安装面板,把端口、Docker、数据库、备份、应用商店全检查一遍。

如果不是空机,只额外做一件事:先去服务商后台创建快照。这样万一不想继续用 1Panel,回滚会省很多事。

一、开始安装:一条官方命令

通过 SSH 登录 VPS,切到 root 用户或具有 sudo 权限的用户。然后执行官方在线安装命令:

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

接下来按终端提示走即可。

安装时会涉及面板端口、用户名、密码和安全入口。这里不用追求花哨,记住两个原则就行:密码不要太简单;安全入口不要用容易猜的单词。安装完成后,终端会把访问地址打印出来。

把这段信息保存好。尤其是面板地址、安全入口和账号密码,不要顺手丢到群聊或公开截图里。

1Panel 的安装脚本和版本会更新。如果命令报错,先回到 1Panel 官方安装文档 看最新说明,不要急着找来路不明的一键脚本。

二、浏览器打不开面板?先看这两个地方

安装完成后,用终端输出的地址在浏览器打开 1Panel。

如果打不开,通常不是面板没装上,而是端口没放行。

云服务器有两道门:一层是 VPS 自己的防火墙,另一层是服务商后台的安全组。面板使用哪个端口,就在两边放行哪个端口。

如果你忘了安装时生成的安全入口,重新 SSH 登录服务器,执行:

1pctl user-info

它会显示当前访问 1Panel 所需的信息。这个命令比重装面板有用得多。

三、第一次登录后,先做两件事

登录进面板后,先别急着打开应用商店装 WordPress、MySQL、Redis。

第一件事,是确认首页能正常看到服务器信息,容器模块没有报错。1Panel 后续的网站、应用和数据库功能都依赖 Docker;这里正常,后面才有得玩。

第二件事,是记住面板和网站的关系。面板本身是你管理服务器的入口,不是对外的网站。后面真正上线项目时,通常会是这样:

域名访问
  ↓
OpenResty 接收 80 / 443 请求
  ↓
转给 PHP、Node.js、Python 或 Docker 中的应用

现在不需要理解每一层。只要先知道:以后 Node.js、Python 这类项目会有自己的运行端口,通常不用把这些端口直接开放给公网。

四、先别安装这些应用

应用商店里会看到 WordPress、Halo、MySQL、Redis、OpenResty,以及各种自托管应用。它们都不是 1Panel 安装完成后必须立刻装的东西。

你准备做什么,再装什么:

你想做的事 后面该看哪一篇
装 WordPress、Halo 或其他现成应用 第二篇:应用商店和建站基础
部署自己的 PHP 网站 PHP 项目部署篇
部署 Node.js API、前端 SSR 项目 Node.js 项目部署篇
部署 Flask、Django、FastAPI Python 项目部署篇
申请 SSL、做备份、看日志 长期维护篇

把一台 1GB 或 2GB VPS 塞满数据库、缓存、监控和各种“以后可能会用”的应用,最后只会让自己不知道哪一个在吃内存。先把一个目标跑通,比面板装满更重要。

五、几个新手常见问题

1Panel 必须安装 Docker 吗?

需要。1Panel 的应用与很多管理能力基于 Docker。交互式安装过程中会处理相关问题;如果你的系统安装 Docker 时出现不兼容提示,按官方文档先手动安装并启动 Docker,再继续安装 1Panel。

1GB VPS 能不能用?

能装,但别期待它同时扛住面板、数据库、WordPress 和多个容器。只体验面板或跑轻量静态站可以试试;准备长期建站,2GB 起步更实在。

已有宝塔或 aaPanel,还能安装 1Panel 吗?

不建议直接叠装。多个面板都可能管理 Docker、Web 服务、端口和防火墙,出了问题很难分清是谁改的。要迁移就单独规划迁移,不要在生产机上随手安装。

面板地址忘了怎么办?

SSH 登录服务器后执行 1pctl user-info。它会显示当前面板的用户访问信息。

接下来应该装 WordPress 还是 OpenResty?

先别凭名字猜。第二篇会把应用商店、运行环境、网站和 Docker Compose 的关系说清楚,再按“WordPress、静态站、PHP、Node.js、Python、自带 Compose 项目”分别选择部署方式。

结语

到这里,1Panel 已经装好了。第一步其实没什么玄学:一台能联网的常见 Linux VPS,一条官方安装命令,再用终端给出的地址登录后台。

站内相关阅读

上一篇 VPS 部署 Hermes Agent(三):定时任务、监控告警与自动备份,让它真正帮你管服务器
下一篇 Hermes Agent 精选必备 Skills:VPS 部署后,先给它补哪几种能力?