第二章 安装与初始化

一句话先给结论

安装一条命令,初始化五件事:改端口、设安全入口、同步防火墙、改账号密码、做一次快照。做完这五件事,你的面板才算真正「装好」。

很多人对「安装」的理解停留在「控制台打出安装成功」那一刻。其实那只是把面板放到了服务器上——这时候你的面板端口可能是随机生成的、安全入口可能没设、账号密码还是安装时随手填的、本机防火墙可能还没开。装完≠能用,能用≠安全。 这一章讲的完整链条是:装上 → 登进去 → 配安全 → 验证 → 留后路。

这一章回答四个问题

小节 问题 一句话答案
2.1 怎么装? 在线一条命令;内网用离线包;批量装机用非交互参数
2.2 装完第一次登录干什么? 跑一遍初始化向导,把面板设置调成你的
2.3 安全加固具体怎么操作? 端口、安全入口、SSL、账号四件事逐项配,配完验证
2.4 命令行怎么管?装失败了怎么办? 1pctl 速查表 + 六种常见失败的对应解法

安装方式怎么选:三选一

1Panel 的安装方式不是只有一种,先帮你选对路子:

方式 适合谁 需要联网吗 操作量
在线安装(交互式) 绝大多数人:第一次装、单台机器 需要 一条命令,按提示回答几个问题
在线安装(非交互式) 批量部署、云服务器初始化脚本、CI/CD 需要 提前用环境变量传好参数,一条命令装完
离线安装 内网 / 无法访问公网的机器 不需要 去官方社区下载页下离线包,上传后执行 install.sh

一句话决策:能上网就在线装,上不了网就离线装,要一次装几十台就非交互装。

安装全过程:一条时间线

把从「空服务器」到「能放心用的面板」全程画出来,你就知道每一步在干嘛:

① SSH 登录服务器(root 或 sudo 权限)
② 执行安装脚本(脚本会检测系统、按需装 Docker)
③ 按提示设置:安装目录、端口、安全入口、用户名、密码
④ 控制台打印访问信息 → 当场记下来!
⑤ 云安全组 + 本机防火墙放行端口(2.3 节)
⑥ 浏览器打开 http://IP:端口/安全入口,登录
⑦ 检查更新 → 初始化设置 → 建一个快照留后路(2.2 节)
⑧ 开始用:装应用、建网站(第三、四章)

④ 是最容易出事的一步:访问信息只在控制台打印一次,很多人当时没记、关掉终端就找不回。虽然可以 SSH 上去用 1pctl user-info 重新查(2.4 节),但「当场记下来」这个习惯能少走很多弯路。

打个比方:装面板像装修新房

把整章串成一个生活类比:

装修 装 1Panel
拿到毛坯房 买了一台空 Linux 服务器
请施工队(水电改造) 安装脚本(顺带把 Docker 这些「水电」装好)
换掉开发商的门锁 改面板端口(2.3 节)
给大门设暗号 设安全入口(2.3 节)
物业登记、配门禁卡 改用户名密码、开 MFA(2.3 节)
验收:每个灯都开一遍 验证:换浏览器、换网络能打开(2.3 节)
拍照留存装修前的样子 创建快照,出问题能回滚(2.2 节)
买家具、挂窗帘 装应用、建网站(第三章起)

「换门锁」和「验收」这两步,绝大多数新手会跳过。 装完就直接开始建站,等出事才发现端口默认、入口没设、没有快照。这一章的存在,就是帮你把这几步补上。

如果装到一半失败了怎么办

新手最怕的就是「装到一半报错」。先建立两个观念:

第一,安装脚本支持重试。 绝大多数失败(网络超时、Docker 没装上、端口冲突)解决掉根因后,重新执行一次安装命令就行——已装成功的部分不需要手动清理。

第二,先看是哪一层失败。 安装过程拆开看是三件事:下载安装包(网络)、装 Docker(环境)、初始化面板(配置)。报错信息里带 download/curl 是网络层,带 docker 是环境层,打印出面板访问地址了就是配好了。分层定位,比一通乱试快得多。第二章 2.4 节把官方 FAQ 里的典型安装失败整理成了一张排查表,装之前扫一眼,真出事了对号入座。

五件必做事:贯穿全章的主线

不管你用哪种安装方式,装完之后这五件事一件都不能少:

# 事项 在哪做 为什么必须
1 改面板端口 安装时 或 面板设置 → 安全 默认/常见端口是扫描脚本的第一目标
2 设安全入口 安装时 或 面板设置 → 安全 让别人连登录页都看不到
3 同步两道防火墙 云安全组 + 主机 → 防火墙 两道都开,只开一道等于没开
4 改账号密码 + MFA 左下角头像 → 用户信息 账号是最后一道门
5 建一次快照 面板设置 → 快照 出问题时唯一能整体回滚的手段

前四件在 2.3 节展开操作细节,第五件在 2.2 节讲。「五件事」这个说法第一章 1.1 节提过,这里给出落点。

这一章的两个约定

  1. 所有命令都可复制。代码块里的命令、参数都来自官方文档,照着粘到终端里就能跑。
  2. 每一步都标出坑。哪些操作会把你锁在门外、哪些步骤不可逆、哪里必须验证,都会单独提示。

如果你还没准备好服务器,先回第一章 1.3 节把准备清单过一遍;如果想更细的官方参数说明,对照《1Panel 官方文档:产品介绍与安装部署》里的安装章节。

下一节:从系统要求开始——在线、离线、非交互,三种安装方式手把手走一遍。