2.1 系统要求与在线、离线安装

一句话回答

在线安装就是一条命令：bash -c "$(curl -sSL .../quick_start.sh)"，跟着提示回答三四个问题；内网环境去官方下载页取离线包，上传后执行 install.sh。真正卡人的不是安装本身，而是系统要求和端口放行。

环境要求：官方红线

先把官方的硬条件摆上来，不满足就别开工：

第一章 1.3 节详细讲过配置选型和端口规划，这里直接进入安装。

在线安装（交互式）：绝大多数人的选择

第一步：执行安装脚本

SSH 登录服务器后，执行官方安装命令：

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

脚本会自动检测系统环境，如果服务器上没有 Docker，它会问你要不要装——1Panel 基于 Docker 管理应用，这一步通常选「装」。如果已经装过 Docker，脚本会跳过。

第二步：按提示回答问题

脚本会依次问你几件事，我按官方文档的参数给你标注重 点：

第三步：记下控制台打印的访问信息

安装成功后，控制台会打印面板访问信息，格式是：

http://目标服务器 IP 地址:目标端口/安全入口

当场复制到记事本或密码管理器。 如果当时没记，SSH 上服务器后执行下面的命令可以重新查：

1pctl user-info

这条命令会输出面板的访问入口等信息——是官方文档明确给的补救手段（2.4 节细讲）。

第四步：放行端口

云服务器特别注意：必须在云厂商的安全组里开放面板端口，否则浏览器打不开。两道防火墙（云安全组 + 本机防火墙）的放行细节在 2.3 节统一讲。

非交互安装：批量部署用

如果你要一次装几十台、或者把安装塞进云服务器的初始化脚本、CI/CD 流水线，就别一问一答了。官方支持用环境变量提前传好参数，启用非交互模式：

PANEL_NON_INTERACTIVE=true \
PANEL_LANG=zh \
PANEL_INSTALL_DIR=/opt \
PANEL_PORT=18080 \
PANEL_ENTRANCE=panelEntrance \
PANEL_USERNAME=panelAdmin \
PANEL_PASSWORD='ChangeMe_123456' \
PANEL_INSTALL_DOCKER=y \
PANEL_DOCKER_MODE=auto \
PANEL_CONFIGURE_ACCELERATOR=n \
PANEL_REPLACE_DAEMON_JSON=n \
bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

参数说明（官方文档原表）：

也可以用命令行参数传同样的配置（在脚本命令后加 -- 再接参数），效果一样。官方的一个安全提醒：优先用 PANEL_PASSWORD 环境变量传密码，别让密码明出现在命令参数里——因为命令参数会留在 shell 历史和进程列表中，容易被别人看到。

两个默认值的坑：

• 非交互模式下，Docker 安装和镜像加速默认不启用（避免脚本偷偷改主机环境）。想要自动装 Docker，必须显式写 PANEL_INSTALL_DOCKER=y。
• 服务器已装 Docker 时通常不用设 PANEL_INSTALL_DOCKER；要配镜像加速才显式设 PANEL_CONFIGURE_ACCELERATOR=y。

示例里的端口、入口、账号密码都是文档演示值（比如 18080、panelEntrance、panelAdmin），生产环境一定换成自己的。上面示例参数只对当前这条安装命令生效，不会写进系统环境变量。

离线安装：内网环境的选择

机房不能访问公网时，走离线安装。官方离线包的获取与使用：

1. 前往 FIT2CLOUD 开源社区下载页面，下载对应架构的离线安装包（企业版离线包提供 x86_64 / amd64 架构）。
2. 把安装包上传到目标服务器并解压。
3. 进入解压后的目录，执行 install.sh，按提示完成安装。
4. 以后升级：下载新版离线包，解压后执行 upgrade.sh。

三个要注意的点：

补救：万一已经放错了包、账号被改掉，SSH 上去执行 1pctl update username 和 1pctl update password 重新设置即可（官方文档原话）。版本选择的分析见第一章 1.2 节，从社区版升级到企业版的迁移步骤见 2.2 节。

一个与安装有关的常见报错

装 1Panel 前脚本会装 Docker，如果你的系统比较小众，可能遇到 ERROR: Unsupported distribution 'xxx'——Docker 官方在线脚本不支持这个发行版。官方给的解法：先手动装好 Docker 再装 1Panel，可以用下面这个第三方脚本：

bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

装好 Docker 后重新执行 1Panel 安装脚本即可。其它安装失败排查（WSL、防火墙规则不生效等）集中在 2.4 节。

安装完成后：怎么升级

登录面板后，在页面右下角点【检查更新】即可在线升级。几条常识：

• 升级会替换 1Panel 二进制文件、1pctl 和 1panel.service；升级失败会自动回滚到更新前状态。
• 如果更新后版本号没变，去 日志审计 → 系统日志 看失败原因，解决了再重试。
• 离线环境升级用离线包里的 upgrade.sh。

本节要点

• 硬条件：Debian/RedHat 系 Linux、可用内存 1GB 以上、在线需联网；
• 在线安装一条命令，交互式回答安装目录、端口、安全入口、账号密码，访问信息当场记；
• 批量部署用非交互模式，PANEL_INSTALL_DOCKER=y 要显式写，密码用环境变量传；
• 内网用离线包：下载 → 上传 → 解压 → install.sh；离线包是企业版，试用期后要手动恢复社区版；
• Docker 装失败报 Unsupported distribution 时，先手动装 Docker 再装面板。

更完整的安装参数说明，见《1Panel 官方文档：产品介绍与安装部署》中的在线安装与离线安装两节。

下一步：装好了，第一次登录进去该干什么——初始化向导与首次配置。