moelin/1panel Docker Image Overview

moelin/1panel

moelin

1Panel是一款开源的Linux服务器运维管理面板，支持通过Docker方式便捷部署运行，为开发者和运维人员提供直观的可视化操作界面，可实现服务器状态实时监控、应用程序一键部署、Docker容器全生命周期管理、文件传输与编辑等核心功能，帮助用户高效管理服务器资源，简化复杂的运维流程，提升日常运维工作效率。

64 次收藏下载次数: 0状态：社区镜像维护者：moelin仓库类型：镜像

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

版本下载

🚀 生产环境还在裸拉官方镜像？一次故障=一次通宵

1Panel Docker 镜像

![Docker Image Version (latest semver)]([] ![Docker Pulls]([] ![Docker Stars]([] ![GitHub Repo stars]([]

[!CAUTION] 重要提示: 1Panel V2 版本与 V1 版本无法直接跨版本升级！

如需从 V1 迁移到 V2，请参考官方迁移文档: [***]

Docker 用户迁移: 如果您以 Docker 方式运行 V1，可通过迁移脚本先切换到宿主机运行模式，再使用官方升级工具升级到 V2，最后可切换回 Docker 运行模式。详见 Q2: 如何从 V1 迁移到 V2?

脚本下载链接: GitHub | cdn.jsdelivr.net | testingcf.jsdelivr.net | quantil.jsdelivr.net | fastly.jsdelivr.net | purge.jsdelivr.net | gcore.jsdelivr.net | originfastly.jsdelivr.net

📑 目录

简介
版本说明
镜像标签
V1 版本使用
- 注意事项
- Docker 安装
- Docker Compose 安装
- 环境变量配置
- 修改面板显示版本
V2 版本使用
- 注意事项
- Docker 安装
- Docker Compose 安装
- 环境变量配置
镜像编译
常见问题
相关链接
声明

简介

本项目提供 1Panel 的 Docker 容器化部署方案，支持 V1 和 V2 两个主要版本。

项目特点:

✅ 支持多架构平台 (amd64, arm64, armv7, ppc64le, s390x)
✅ 自动化构建和版本更新
✅ 提供中国版 (CN) 和国际版 (Global) 镜像
✅ V1/V2 版本均支持环境变量配置 (V1 需 v1.10.34-lts+)
✅ 云原生架构: Supervisor 进程管理 + 动态配置

致谢: 本项目受 1panel-dood 启发，采用替换二进制文件的方式实现容器化部署。

版本说明

版本	下载源	状态	推荐使用
V1	国内/国际	维护中	稳定用户
V2	国内	最新版	新用户

[!WARNING] V1 和 V2 无法直接跨版本升级，迁移请参考: [***]

镜像标签

V1 中国版 (CN)

bash
moelin/1panel:v1.10.22    # 具体版本
moelin/1panel:v1          # 浮动标签 (最新 V1)

V1 国际版 (Global)

bash
moelin/1panel:global-v1.10.22    # 具体版本
moelin/1panel:global-v1          # 浮动标签 (最新 V1 Global)

V2 中国版 (CN)

bash
moelin/1panel:v2.0.6      # 具体版本
moelin/1panel:v2          # 浮动标签 (最新 V2)
moelin/1panel:latest      # 全局最新 (指向 V2)

[!TIP] 标签选择建议

生产环境: 使用具体版本号 (如 v1.10.22)

测试环境: 使用浮动标签 (如 v1, v2)

追求最新: 使用 latest (目前指向 V2)

V1 版本使用

V1 注意事项

[!IMPORTANT] 使用限制

禁止点击面板右下角更新按钮

应通过拉取新镜像并重新部署来更新

[!NOTE] 云原生架构升级 (v1.10.34-lts+)

✅ 支持环境变量动态配置 (端口、用户名、密码、入口)

✅ Supervisor 进程管理，自动重启和日志管理

✅ 首次启动自动配置，支持随机密码生成

⚠️ 仅 v1.10.34-lts 及以后版本支持环境变量配置功能

默认配置:

端口: ***
账户: 1panel
密码: 1panel_password (首次启动可自动生成随机密码)
入口: entrance

支持架构: amd64, arm64, armv7, ppc64le, s390x

V1 Docker 安装

中国版 (CN) - 基础安装

bash
docker run -d \
    --name 1panel \
    --restart always \
    --network host \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /var/lib/docker/volumes:/var/lib/docker/volumes \
    -v /opt:/opt \
    -v /root:/root \
    -e TZ=Asia/Shanghai \
    moelin/1panel:v1

中国版 (CN) - 自定义配置 (v1.10.34-lts+)

bash
docker run -d \
    --name 1panel \
    --restart always \
    --network host \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /var/lib/docker/volumes:/var/lib/docker/volumes \
    -v /opt:/opt \
    -v /root:/root \
    -e TZ=Asia/Shanghai \
    -e PORT=*** \
    -e USERNAME=admin \
    -e PASSWORD=your_secure_password \
    -e ENTRANCE=myentrance \
    moelin/1panel:v1

国际版 (Global) - 基础安装

bash
docker run -d \
    --name 1panel-global \
    --restart always \
    --network host \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /var/lib/docker/volumes:/var/lib/docker/volumes \
    -v /opt:/opt \
    -v /root:/root \
    -e TZ=Asia/Shanghai \
    moelin/1panel:global-v1

国际版 (Global) - 自定义配置 (v1.10.34-lts+)

bash
docker run -d \
    --name 1panel-global \
    --restart always \
    --network host \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /var/lib/docker/volumes:/var/lib/docker/volumes \
    -v /opt:/opt \
    -v /root:/root \
    -e TZ=Asia/Shanghai \
    -e PORT=*** \
    -e USERNAME=admin \
    -e PASSWORD=your_secure_password \
    -e ENTRANCE=myentrance \
    moelin/1panel:global-v1

V1 Docker Compose 安装

基础配置

创建 docker-compose.yml:

yaml
version: '3'
services:
  1panel:
    container_name: 1panel
    restart: always
    network_mode: "host"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
      - /opt:/opt
      - /root:/root
    environment:
      - TZ=Asia/Shanghai
    image: moelin/1panel:v1
    labels:
      createdBy: "Apps"

自定义配置 (v1.10.34-lts+)

yaml
version: '3'
services:
  1panel:
    container_name: 1panel
    restart: always
    network_mode: "host"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /var/lib/docker/volumes:/var/lib/docker/volumes
      - /opt:/opt
      - /root:/root
    environment:
      - TZ=Asia/Shanghai
      - PORT=***
      - USERNAME=admin
      - PASSWORD=your_secure_password
      - ENTRANCE=myentrance
      - BASE_DIR=/opt
    image: moelin/1panel:v1
    labels:
      createdBy: "Apps"

运行:

bash
docker-compose up -d

V1 环境变量配置

[!WARNING] 版本要求: 环境变量配置功能仅在 v1.10.34-lts 及以后版本生效

变量名	默认值	说明
`PORT`	`***`	面板访问端口
`USERNAME`	`1panel`	管理员用户名
`PASSWORD`	`1panel_password`	管理员密码 (首次启动自动生成随机密码)
`ENTRANCE`	`entrance`	安全入口路径
`BASE_DIR`	`/opt`	数据存储目录
`TZ`	`Asia/Shanghai`	时区设置
`RESET`	`false`	设为 `true` 强制重置配置

[!TIP] 密码安全提示

如果不设置 PASSWORD 或使用默认值，首次启动会自动生成随机密码

随机密码会在容器日志中显示，请及时查看并保存

查看日志: docker logs 1panel

修改面板显示版本

[!NOTE] 自 2023-09-19 起，镜像已支持自动修改面板显示版本，无需手动操作

如需手动修改:

1. 安装 SQLite3

bash
# Debian/Ubuntu
apt-get update && apt-get install sqlite3 -y

# RedHat/CentOS
yum install sqlite -y

2. 修改版本信息

bash
# 备份数据库
cp /opt/1panel/db/1Panel.db /opt/1panel/db/1Panel.db.bak

# 打开数据库
sqlite3 /opt/1panel/db/1Panel.db

# 修改版本 (替换 v1.10.22 为实际版本)
UPDATE settings SET value = 'v1.10.22' WHERE key = 'SystemVersion';

# 退出
.exit

# 重启容器
docker restart 1panel

V2 版本使用

V2 注意事项

✅ 支持通过环境变量配置端口、用户名、密码、入口
✅ 支持数据目录映射 (BASE_DIR)
✅ 首次启动自动配置，无需手动初始化
⚠️ 无法从 V1 直接升级，迁移请参考官方文档

V2 Docker 安装

bash
docker run -d \
    --name 1panel-v2 \
    --restart always \
    --network host \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /opt:/opt \
    -e TZ=Asia/Shanghai \
    -e PORT=*** \
    -e USERNAME=admin \
    -e PASSWORD=your_secure_password \
    -e ENTRANCE=myentrance \
    moelin/1panel:v2

V2 Docker Compose 安装

创建 docker-compose.yml:

yaml
version: '3'
services:
  1panel-v2:
    container_name: 1panel-v2
    restart: always
    network_mode: "host"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt:/opt
    environment:
      - TZ=Asia/Shanghai
      - PORT=***
      - USERNAME=admin
      - PASSWORD=your_secure_password
      - ENTRANCE=myentrance
      - BASE_DIR=/opt
    image: moelin/1panel:v2
    labels:
      createdBy: "Apps"

运行:

bash
docker-compose up -d

环境变量配置

变量名	默认值	说明
`PORT`	`***`	面板访问端口
`USERNAME`	`1panel`	管理员用户名
`PASSWORD`	`1panel_password`	管理员密码 (首次启动自动生成随机密码)
`ENTRANCE`	`entrance`	安全入口路径
`BASE_DIR`	`/opt`	数据存储目录
`TZ`	`Asia/Shanghai`	时区设置
`RESET`	`false`	设为 `true` 强制重置配置

[!TIP] 密码安全提示

如果不设置 PASSWORD 或使用默认值，首次启动会自动生成随机密码

随机密码会在容器日志中显示，请及时查看并保存

查看日志: docker logs 1panel-v2

镜像编译

V1 编译

bash
# 单架构编译
docker build --build-arg PANELVER=v1.10.22 -t 1panel:v1.10.22 ./V1

# 多架构编译并推送
docker buildx build \
  --platform linux/amd64,linux/arm64,linux/arm/v7,linux/ppc64le,linux/s390x \
  --build-arg PANELVER=v1.10.22 \
  -t <your-dockerhub-username>/1panel:v1.10.22 \
  --push \
  ./V1

V1 Global 编译

bash
docker buildx build \
  --platform linux/amd64,linux/arm64,linux/arm/v7,linux/ppc64le,linux/s390x \
  --build-arg PANELVER=v1.10.22 \
  -t <your-dockerhub-username>/1panel:global-v1.10.22 \
  -f ./V1/Dockerfile-Global \
  --push \
  ./V1

V2 编译

bash
docker buildx build \
  --platform linux/amd64,linux/arm64,linux/arm/v7,linux/ppc64le,linux/s390x \
  --build-arg PANELVER=v2.0.6 \
  -t <your-dockerhub-username>/1panel:v2.0.6 \
  --push \
  ./V2

常见问题

Q1: V1 和 V2 如何选择?

V1 适合:

已有 V1 部署且运行稳定
不需要最新功能
追求稳定性

V2 适合:

新用户首次部署
需要最新功能和性能优化
愿意接受新架构

Q2: 如何从 V1 迁移到 V2?

[!CAUTION] 无法直接升级！

请参考官方迁移文档: [***]

[!TIP] Docker 运行模式迁移方案

如果您当前以 Docker 方式运行 1Panel V1，可以通过以下步骤迁移到 V2:

步骤 1: 使用迁移脚本将 1Panel 从 Docker 运行模式切换到宿主机运行模式

bash
# GitHub 源
wget -O 1panel_docker_to_sys.sh [***]
# jsDelivr 源 (以下任选其一，国内加速)
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
wget -O 1panel_docker_to_sys.sh [***]
# 下载完成后，添加执行权限并运行
chmod +x 1panel_docker_to_sys.sh && bash 1panel_docker_to_sys.sh

步骤 2: 使用官方升级工具将 V1 升级到 V2

参考官方文档: [***]

步骤 3: 升级完成后，如需切换回 Docker 运行模式，可重新使用迁移脚本切换回 Docker 运行模式

Q3: 容器内如何执行 1pctl 命令?

bash
# 进入容器
docker exec -it 1panel bash

# V1 执行命令
1pctl version

# V2 执行命令
1pctl version

Q4: 如何查看容器日志?

bash
# V1
docker logs 1panel

# V2
docker logs 1panel-v2

# 实时查看
docker logs -f 1panel-v2

声明

本项目部分文档内容由 AI 辅助生成。

这是一款即开即用、灵活高效的RAG聊天机器人，基于检索增强生成技术，无需复杂配置即可直接部署使用，具备高度灵活性以适配多样化的应用场景与数据需求，通过高效检索外部知识库信息并结合生成式AI能力，能够精准理解用户需求、提供准确且上下文相关的智能响应。

新一代开源AI CRM系统，作为Salesforce CRM的开源替代方案。

KubePi 是一个现代化的 Kubernetes 面板，支持导入多个 K8s 集群，通过权限控制分配不同集群和命名空间权限给用户，帮助管理员和开发人员管理集群应用、进行故障排查，简化 K8s 集群复杂性。

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

docker search 报错：专属域名下仅支持 Docker Hub 查询

docker search 报错问题

网页搜不到镜像：Docker Hub 有但轩辕镜像搜索无结果

镜像搜索不到

离线传输镜像：无法直连时用 docker save/load 迁移

离线传输镜像

Docker 插件安装错误：application/vnd.docker.plugin.v1+json

Docker 插件安装错误

WSL 下 Docker 拉取慢：网络与挂载目录影响及优化

WSL 拉取镜像慢

轩辕镜像是否安全？镜像完整性校验（digest）说明

镜像安全性

如何用轩辕镜像拉取镜像？登录方式与专属域名配置

如何拉取镜像

错误码与失败问题

manifest unknown 错误：镜像不存在或标签错误

manifest unknown 错误

TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误

TLS 证书验证失败

DNS 解析超时：无法解析镜像仓库地址或连接超时

DNS 解析超时

410 Gone 错误：Docker 版本过低导致协议不兼容

410 错误：版本过低

402 Payment Required 错误：流量耗尽错误提示

402 错误：流量耗尽

401 UNAUTHORIZED 错误：身份认证失败或登录信息错误

身份认证失败错误

429 Too Many Requests 错误：请求频率超出专业版限制

429 限流错误

Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）

凭证保存错误

账号 / 计费 / 权限

免费版与专业版区别：功能、限额与使用场景对比

免费版与专业版区别

支持的镜像仓库：Docker Hub、GCR、GHCR、K8s 等列表

轩辕镜像支持的镜像仓库

拉取失败是否扣流量？计费规则说明

拉取失败流量计费

KYSEC 权限不够：麒麟 V10/统信 UOS 下脚本执行被拦截

KYSEC 权限错误

如何申请开具发票？（增值税普票/专票）

开具发票

如何修改网站与仓库登录密码？

修改网站和仓库密码

配置与原理类

registry-mirrors 未生效：仍访问官方仓库或报错的原因

registry-mirrors 未生效

如何去掉镜像名称中的轩辕域名前缀？（docker tag）

去掉域名前缀

如何拉取指定架构镜像？（ARM64/AMD64 等多架构）

拉取指定架构镜像

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"

moelin/1panel Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

1Panel Docker 镜像

📑 目录

简介

版本说明

镜像标签

V1 中国版 (CN)

V1 国际版 (Global)

V2 中国版 (CN)

V1 版本使用

V1 注意事项

V1 Docker 安装

中国版 (CN) - 基础安装

中国版 (CN) - 自定义配置 (v1.10.34-lts+)

国际版 (Global) - 基础安装

国际版 (Global) - 自定义配置 (v1.10.34-lts+)

V1 Docker Compose 安装

基础配置

自定义配置 (v1.10.34-lts+)

V1 环境变量配置

修改面板显示版本

1. 安装 SQLite3

2. 修改版本信息

V2 版本使用

V2 注意事项

V2 Docker 安装

V2 Docker Compose 安装

环境变量配置

镜像编译

V1 编译

V1 Global 编译

V2 编译

常见问题

Q1: V1 和 V2 如何选择?

Q2: 如何从 V1 迁移到 V2?

Q3: 容器内如何执行 1pctl 命令?

Q4: 如何查看容器日志?

相关链接

声明

轩辕镜像配置手册

Docker 配置

登录仓库拉取

专属域名拉取

K8s Containerd

K3s

Dev Containers

Podman

Singularity/Apptainer

其他仓库配置

系统配置

Linux

Windows/Mac

MacOS OrbStack

Docker Compose

NAS 设备

群晖

飞牛

绿联

威联通

极空间

网络设备

爱快路由

宝塔面板

镜像拉取常见问题

使用与功能问题

docker search 报错：专属域名下仅支持 Docker Hub 查询

网页搜不到镜像：Docker Hub 有但轩辕镜像搜索无结果

离线传输镜像：无法直连时用 docker save/load 迁移

Docker 插件安装错误：application/vnd.docker.plugin.v1+json

WSL 下 Docker 拉取慢：网络与挂载目录影响及优化

轩辕镜像是否安全？镜像完整性校验（digest）说明

如何用轩辕镜像拉取镜像？登录方式与专属域名配置

错误码与失败问题

manifest unknown 错误：镜像不存在或标签错误

TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误

DNS 解析超时：无法解析镜像仓库地址或连接超时

410 Gone 错误：Docker 版本过低导致协议不兼容

402 Payment Required 错误：流量耗尽错误提示

401 UNAUTHORIZED 错误：身份认证失败或登录信息错误

429 Too Many Requests 错误：请求频率超出专业版限制