1Panel 安装常见问题与解决方案指南

安装

参考 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 等命令