欢迎光临
我们一直在努力
        找回密码
当前位置：云服务器推荐 服务器运维 正文

1Panel开源Linux运维面板Docker部署教程：V1与V2版本完整指南

2026-10-11 分类：服务器运维 阅读(3) 评论(0)

1Panel 简介

1Panel 是一款现代化的 Linux 服务器运维管理面板，本文提供其 Docker 容器化部署方案，支持 V1 和 V2 两个主要版本。通过 Docker 部署，可以实现环境隔离、快速迁移和便捷备份，同时避免宿主机环境冲突。该面板具备以下核心优势：

  • 一键建站：支持 WordPress、Discuz、Typecho 等常用建站程序。
  • Docker 管理：可视化操作容器和镜像。
  • 数据备份：支持定时备份至云端。
  • 安全管理：防火墙和 SSL 证书一键配置。
  • 多架构支持：兼容 amd64、arm64、armv7、ppc64le、s390x 架构，适配鲲鹏、飞腾等国产服务器。
  • 自动化更新：镜像支持自动化构建和版本更新，提供中国版（CN）和国际版（Global）。
  • 云原生架构：采用 Supervisor 进程管理，支持环境变量灵活配置（V1 需 v1.10.34-lts+）。

1Panel 与宝塔面板的区别

1Panel 和宝塔代表了两种不同的设计哲学：1Panel 是“云原生、容器化”的新派代表，而宝塔是“传统、全能”的老牌巨头。选择哪个取决于对开源与安全的重视程度，以及对 Docker 容器技术的接受程度。以下是它们在各个维度的详细对比：

  • 核心性质：1Panel 完全开源免费；宝塔商业化闭源为主，提供免费版。
  • 技术架构：1Panel 容器优先（基于 Docker）；宝塔传统架构（LNMP/LAMP 直接安装在宿主机）。
  • 资源占用：1Panel 较低，自身占用约 50-100MB；宝塔相对较高，安装后常占用 200-400MB。
  • 安全性：1Panel 容器隔离，代码开源可审计；宝塔有争议，历史上曾曝出安全漏洞。
  • 易用性：1Panel 界面现代化，但有一定学习成本；宝塔新手友好，教程丰富。
  • 应用生态：1Panel 聚焦容器化应用（约 150+）；宝塔传统插件多（约 200+）。
  • 强制登录：1Panel 无强制登录，尊重隐私；宝塔需绑定手机号。

环境准备：一键安装 Docker

在部署 1Panel 之前，需要先安装 Docker 环境。推荐使用轩辕镜像的一键安装脚本，它能自动处理 Docker、Docker Compose 的安装，并配置好国内镜像源。该脚本支持 13+ 种 Linux 发行版（包括 openEuler、Anolis、麒麟等国产系统），完整支持 x86_64 和 ARM 架构，并自动配置轩辕镜像源，加速镜像拉取。

执行以下命令：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

脚本运行后，等待几分钟即可完成 Docker 环境部署。

镜像拉取：使用国内加速与镜像标签选择

由于 Docker Hub 在国内访问较慢，可以通过轩辕镜像加速拉取。1Panel 目前有 V1 和 V2 两个主要版本，重要提示：V1 和 V2 无法直接跨版本升级。如需从 V1 迁移到 V2，请参考官方迁移文档：https://1panel.cn/docs/v2/installation/v1_migrate/。

版本说明与镜像标签选择

  • V1：国内/国际维护中，适合已有 V1 部署、追求稳定性的用户。国内版标签：v1.10.22（具体版本）、v1（浮动标签，最新 V1）；国际版标签：global-v1.10.22、global-v1。
  • V2：国内最新版，适合新用户首次部署、需要最新功能的用户。标签：v2.0.6（具体版本）、v2（浮动标签）、latest（全局最新，指向 V2）。

标签选择建议

  • 生产环境：使用具体版本号（如 v1.10.22、v2.0.6），避免版本自动更新导致异常。
  • 测试环境：使用浮动标签（如 v1、v2），方便快速获取对应版本的最新更新。
  • 追求最新：使用 latest（目前指向 V2 版本）。

具体拉取命令

拉取 V2 版本（推荐新用户）：

docker pull docker.xuanyuan.run/moelin/1panel:v2

拉取 V1 版本（老用户维护）：

docker pull docker.xuanyuan.run/moelin/1panel:v1

拉取国际版（需外网环境）：

docker pull docker.xuanyuan.run/moelin/1panel:global-v1

开始部署：V2 版本（新用户首选）

V2 是最新版本，功能更强，架构更优，支持环境变量动态配置、数据目录映射，首次启动自动配置，无需手动初始化。这里提供 Docker 命令直接运行和 Docker Compose 两种方式，可任选其一。V2 版本支持通过环境变量灵活配置，首次启动若未设置密码，会自动生成随机密码（可通过日志查看）。

方式一：使用 docker run 命令（快速上手）

复制以下命令，可根据需要修改环境变量（如端口、密码、安全入口等）：

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=10086 
  -e USERNAME=admin 
  -e PASSWORD=your_secure_password 
  -e ENTRANCE=myentrance 
  -e BASE_DIR=/opt 
  docker.xuanyuan.run/moelin/1panel:v2

关键优化说明

  • --restart always：容器异常退出或 Docker 重启后自动拉起，保障面板持续运行。
  • --network host：使用宿主机网络，避免端口映射冲突，简化配置。
  • -v /var/run/docker.sock:/var/run/docker.sock：映射 Docker 守护进程，实现面板对 Docker 的可视化管理。
  • -v /opt:/opt：数据卷持久化，结合 BASE_DIR 环境变量，避免容器删除后配置、数据丢失。
  • -e TZ=Asia/Shanghai：设置时区为中国标准时间，确保日志和定时任务时间正确。

环境变量配置详情（V2 版本）

  • PORT：默认值 10086，面板访问端口。
  • USERNAME：默认值 1panel，管理员用户名。
  • PASSWORD：默认值 1panel_password，管理员密码，未设置或使用默认值时，首次启动会自动生成随机密码（日志中查看）。
  • ENTRANCE：默认值 entrance，安全入口路径，访问地址格式：http://IP:端口/入口路径。
  • BASE_DIR：默认值 /opt，数据存储目录，需与挂载目录保持一致。
  • TZ：默认值 Asia/Shanghai，时区设置。
  • RESET：默认值 false，设为 true 可强制重置面板配置。

方式二：使用 docker-compose（推荐）

使用 Compose 更方便管理和维护，可直接固化配置，后续启动、停止更便捷，还可添加标签便于识别。创建一个 docker-compose.yml 文件：

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=10086
      - USERNAME=admin
      - PASSWORD=your_secure_password
      - ENTRANCE=myentrance
      - BASE_DIR=/opt
    image: docker.xuanyuan.run/moelin/1panel:v2
    labels:
      createdBy: "Apps"

启动服务：

docker-compose up -d

老用户专区：V1 版本部署

如果你是 V1 的老用户，或者出于稳定考虑想使用 V1，部署步骤如下。重要注意事项：V1 版本禁止点击面板右下角更新按钮，应通过拉取新镜像并重新部署来更新；仅 v1.10.34-lts 及以后版本支持环境变量配置。

V1 版本默认配置

  • 端口：10086
  • 账户：1panel
  • 密码：1panel_password（首次启动可自动生成随机密码，日志中查看）
  • 入口：entrance
  • 支持架构：amd64, arm64, armv7, ppc64le, s390x

Docker Run 命令

中国版 (CN) – 基础安装（无自定义配置）：

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 
  docker.xuanyuan.run/moelin/1panel:v1

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

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=10086 
  -e USERNAME=admin 
  -e PASSWORD=your_secure_password 
  -e ENTRANCE=myentrance 
  -e BASE_DIR=/opt 
  docker.xuanyuan.run/moelin/1panel:v1

国际版 (Global) – 基础安装：

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 
  docker.xuanyuan.run/moelin/1panel:global-v1

Docker Compose 安装

基础配置：创建 docker-compose.yml：

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: docker.xuanyuan.run/moelin/1panel:v1
    labels:
      createdBy: "Apps"

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

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=10086
      - USERNAME=admin
      - PASSWORD=your_secure_password
      - ENTRANCE=myentrance
      - BASE_DIR=/opt
    image: docker.xuanyuan.run/moelin/1panel:v1
    labels:
      createdBy: "Apps"

启动服务：

docker-compose up -d

修改面板显示版本（可选）

自 2023-09-19 起，镜像已支持自动修改面板显示版本，无需手动操作；如需手动修改，步骤如下：

安装 SQLite3：

# Debian/Ubuntu
apt-get update && apt-get install sqlite3 -y
# RedHat/CentOS
yum install sqlite -y

修改版本信息：

# 备份数据库
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

常用操作与维护

1. 查看面板信息与日志

如果忘记了端口、入口或自动生成的密码，可以通过日志查看，支持实时查看日志排查问题：

# V2 查看日志
docker logs 1panel-v2
# V2 实时查看日志
docker logs -f 1panel-v2
# V1 查看日志
docker logs 1panel
# V1 实时查看日志
docker logs -f 1panel

2. 在容器内使用 1pctl 命令行工具

如果需要执行 1Panel 的命令行工具（如查看版本、执行运维操作），步骤如下：

# 进入容器（V2）
docker exec -it 1panel-v2 bash
# 进入容器（V1）
docker exec -it 1panel bash
# 执行命令 (例如查看版本)
1pctl version

3. 镜像更新（避免面板内更新）

无论是 V1 还是 V2 版本，均不建议在面板内点击更新按钮，正确的更新方式为：

  1. 拉取最新镜像（对应版本标签）。
  2. 停止并删除旧容器。
  3. 使用原配置命令重新启动新容器（确保数据卷挂载正确，避免数据丢失）。

常见问题 (FAQ)

Q1: V1 和 V2 怎么选？我能直接升级吗？

新用户：无脑选 V2，功能更强、架构更优，支持更多便捷配置。老用户：建议继续用 V1 稳定运行，无需强行迁移。⚠️ 重要：V1 和 V2 无法直接跨版本升级。如果一定要迁移，需要先把 Docker 版的 1Panel 用迁移脚本转到宿主机运行，升级后再转回来。

Q2: 如何从 V1 迁移到 V2？

具体迁移步骤如下（Docker 运行模式专用）：

  1. 使用迁移脚本将 1Panel 从 Docker 运行模式切换到宿主机运行模式（国内推荐使用 jsDelivr 源，任选其一）： 
    # GitHub 源
wget -O 1panel_docker_to_sys.sh https://raw.githubusercontent.com/okxlin/ToolScript/refs/heads/main/1Panel/1panel-execution-mode/1panel_docker_to_sys.sh
# jsDelivr 源（国内加速）
wget -O 1panel_docker_to_sys.sh https://cdn.jsdelivr.net/gh/okxlin/ToolScript@main/1Panel/1panel-execution-mode/1panel_docker_to_sys.sh
wget -O 1panel_docker_to_sys.sh https://testingcf.jsdelivr.net/gh/okxlin/ToolScript@main/1Panel/1panel-execution-mode/1panel_docker_to_sys.sh
wget -O 1panel_docker_to_sys.sh https://quantil.jsdelivr.net/gh/okxlin/ToolScript@main/1Panel/1panel-execution-mode/1panel_docker_to_sys.sh
# 下载完成后，添加执行权限并运行
chmod +x 1panel_docker_to_sys.sh && bash 1panel_docker_to_sys.sh
  2. 使用官方升级工具将 V1 升级到 V2，参考官方文档：升级说明 – 1Panel 文档。
  3. 升级完成后，如需切换回 Docker 运行模式，可重新使用迁移脚本切换。

Q3: 面板启动了但访问不了？

  • 检查防火墙是否放行了你设置的端口（默认 10086）。
  • 如果是云服务器，检查安全组规则，确保对应端口对外开放。
  • 检查容器是否正常运行（docker ps），若未运行，查看日志排查异常（docker logs 容器名）。

Q4: 容器内如何执行 1pctl 命令？

# 进入容器（V2）
docker exec -it 1panel-v2 bash
# 进入容器（V1）
docker exec -it 1panel bash
# 执行命令 (例如查看版本)
1pctl version

Q5: 忘记管理员密码怎么办？

若未设置自定义密码，首次启动的随机密码可通过容器日志查看（docker logs 容器名）。若已设置密码，可通过重新启动容器，添加 -e RESET=true 环境变量，强制重置配置（会清空原有配置，谨慎使用）。

其他服务器运维管理面板

  • mdserver-web：界面神似宝塔，轻量级，适合宝塔老用户希望平滑迁移，低配服务器。
  • InPanel：极低内存占用，非入侵式，适合资源极度有限的 VPS，追求系统纯净。
  • Webmin：历史悠久，功能强大，插件丰富，适合需要深度、全面管理服务器的专业用户。
  • Cockpit：与系统紧密结合，轻量简洁，适合管理单台 Linux 服务器，NAS 环境。
  • LeePanel：桌面端软件，服务器零安装，高安全，适合对面板安全极度敏感，喜欢桌面应用的用户。
  • Nexterm：整合 SSH/VNC/RDP/Docker 等多种协议，适合需要管理多种类型服务器或服务的运维人员。
  • Termix：专注 Web SSH 终端与隧道管理，适合频繁进行 SSH 操作和隧道管理的开发者。

总结

通过 Docker 部署 1Panel，可以在几分钟内获得一个功能强大的服务器管理面板。配合轩辕镜像的一键脚本，无论是国产服务器架构还是国内网络环境，都能实现快速部署、稳定运行。本文整合了 1Panel 两个版本的详细部署步骤、镜像标签选择、环境变量配置及常见问题解决方案，覆盖新老用户需求，助力大家避坑高效运维。

赞(0) 打赏
未经允许不得转载：云服务器推荐 » 1Panel开源Linux运维面板Docker部署教程：V1与V2版本完整指南
分享到

相关推荐

评论 抢沙发

取消

更好的WordPress主题

支持快讯、专题、百度收录推送、人机验证、多级分类筛选器，适用于垂直站点、科技博客、个人站，扁平化设计、简洁白色、超多功能配置、会员中心、直达链接、文章图片弹窗、自动缩略图等...

联系我们联系我们

觉得文章有用就打赏一下文章作者

非常感谢你的打赏，我们将继续提供更多优质内容，让我们一起创建更加美好的网络世界！

支付宝扫一扫

微信扫一扫

登录

找回密码

注册