第一章　安装与部署排错

先说一句大实话

1Panel 最让人崩溃的时刻，不是用的时候，而是装的时候。

后面所有章节讲的问题——网站 502、证书续签失败、数据库连不上——前提都是面板已经跑起来了。而“装不上、打不开、登不进”这九个字，拦住了至少一半的新用户。

更扎心的是：这类问题往往不是 1Panel 的 bug，而是服务器环境、网络、防火墙这三件事没对上。所以这一章我们不讲“怎么装”（那是官方安装文档的活儿），只讲“装不上的时候怎么办”。

一个排错的心法

先记住一个顺序，后面每一节都按它走：

现象 → 可能原因 → 排查命令 → 修复办法

翻译成人话就是四步：

关键点：不要跳步。很多人一看到“打不开”就直接重装，改了十遍还是打不开——因为他始终没分清是“面板没起来”还是“端口没放行”。这两个问题的修法完全相反。

装不上 vs 打不开 vs 登不进

这三个症状后面会反复出现，先分清楚：

注意第三种最容易被误判：页面能打开就以为“装好了”，其实是面板的安全机制在拦你。这时候重装面板没有用，要用 1pctl reset 系列命令。

这一章解决四个问题

装之前：三种安装方式怎么选

官方提供了不止一种装法，选错方式后面排错会走弯路：

有个常见的误解：以为离线安装包“功能少”。其实离线包已集成企业版核心功能，安装后可免费体验一段时间企业版全功能，体验期结束需要手动恢复社区版。价格与试用政策一律以官网为准，别听二手消息。

你需要提前准备的三样东西

排错的时候，这三样东西能帮你省掉 90% 的折腾：

1. SSH 能连上服务器。这是最后的退路。面板打不开时，命令行是你唯一的通道。所以装面板之前，务必确认 SSH 是通的。
2. 云服务商的控制台账号。安全组规则只能在云控制台改，面板里改不了。
3. 安装时控制台打印的那段信息。官方文档写得很清楚：安装成功后会打印面板地址、端口、安全入口。丢了也别慌，SSH 上去执行 1pctl user-info 能再看一遍。

一条容易被忽略的边界

1Panel 官方明确说过：面板基于 Golang 编写，可执行文件约 40MB，运行时占用内存约 150MB，对系统侵入很小。这意味着——如果你服务器装完 1Panel 之后“变卡了”，那大概率不是 1Panel 的锅，而是它管的那些容器（数据库、OpenResty、各种应用）在吃资源。

第四章会专门讲资源占用怎么查。这里先埋个种子：排查问题的第一步，是别急着找替罪羊。

本章会反复出现的命令速查

这些命令不是死记的，用到的时候再回来查这一页就行。更完整的命令说明见 1Panel 官方文档：1pctl 命令行工具。

下一节：我们先从最常见的“安装失败”说起——脚本卡住、Docker 报错、装到一半退出，一个一个拆开看。