第二章 安装与初始化
一句话先给结论
安装一条命令,初始化五件事:改端口、设安全入口、同步防火墙、改账号密码、做一次快照。做完这五件事,你的面板才算真正「装好」。
很多人对「安装」的理解停留在「控制台打出安装成功」那一刻。其实那只是把面板放到了服务器上——这时候你的面板端口可能是随机生成的、安全入口可能没设、账号密码还是安装时随手填的、本机防火墙可能还没开。装完≠能用,能用≠安全。 这一章讲的完整链条是:装上 → 登进去 → 配安全 → 验证 → 留后路。
这一章回答四个问题
| 小节 | 问题 | 一句话答案 |
|---|---|---|
| 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.3 节把准备清单过一遍;如果想更细的官方参数说明,对照《1Panel 官方文档:产品介绍与安装部署》里的安装章节。
下一节:从系统要求开始——在线、离线、非交互,三种安装方式手把手走一遍。
