安装
参考 1Panel 文档 - 在线安装 部分，这里仅作常见安装失败的问题解析。
常见Q&A
收集自 1Panel微信群，论坛以及GitHub issue
Q1. 安装过程中提示 docker 安装失败
[1Panel Log]: … 启动 docker
Failed to enable unit: Unit file docker.service does not exist.
Failed to start docker.service: Unit docker.service not found.
[1Panel Log]: docker 安装失败
问题解析：
1Panel 应用部署环境依赖于 docker，默认安装脚本会尝试安装 docker，若安装 docker 失败并不会返回报错，会在 docker 启动阶段报错未安装，该问题主要出在国内服务器。
解决办法：
需要用户手动安装docker，参考命令：
curl -fsSL https://get.docker.com | bash -s -- --mirror Aliyun
或者
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
Q2. PVE LXC 架构的虚拟机安装 docker 失败
报错同上
问题解析：
- 内核功能限制：LXC 容器可能没有启用 Docker 所需的特定内核功能，例如 cgroups 等。
- 权限问题：LXC 容器默认情况下可能没有足够的权限来运行 Docker
解决办法：
若为自己配置的 LXC 容器，则可参考 这里的配置。
否则尝试下面这个 docker 安装脚本
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)
Q3. Alpine Linux 安装 1panel 失败
sh: localhost: unknown operand
暂不支持的系统架构，请参阅官方文档，选择受支持的系统。
问题解析：
1Panel 仅支持主流 Linux 发行版本（基于 Debian / RedHat 的发行版，包括国产操作系统）
解决办法：
更换受支持的操作系统。
Q4. 提示 “ERROR: Unsupported distribution ‘xxx’”
问题解析：
上图的错误是由于 docker 的在线安装脚本不支持该操作系统导致。
解决办法：
RockyLinux
# 设置仓库 sudo yum-config-manager \--add-repo \http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo# 安装 Docker sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin# 启动 Docker 服务 sudo systemctl start docker.service sudo systemctl enable docker.service
AlmaLinux
# 更新系统 sudo dnf update sudo dnf install epel-release sudo dnf remove podman# 添加 Docker-CE 存储库 sudo dnf config-manager --add-repo=https://download.docker.com/linux/centos/docker-ce.repo#安装 Docker-CE sudo dnf install docker-ce docker-ce-cli containerd.io# 启动 Docker sudo systemctl start docker.service sudo systemctl enable docker.service
Q5. 使用 windows 的 wsl 子系统安装失败
System has not been booted with systemd as init system (PID 1). Can't operate. Failed to connect to bus: Host is down
问题解析：
上图的错误是由于 wsl 子系统不能使用 systemd 导致的启动 docker 服务失败
解决办法：
更新 systemd 管理，支持 systemd 后问题即可解决
参考文档：Systemd support is now available in WSL!
Q6. command not found 命令未找到
-bash: curl: command not found
-bash: tar: command not found
问题解析：
操作系统缺乏运行脚本的基本命令
解决办法：
自行根据操作系统安装 curl，tar 等命令
