1Panel#

1Panel 是新一代的开源 Linux 服务器运维管理面板，提供 Web 界面的服务器管理、Docker 应用部署、网站托管、数据库管理等功能。

特点#

特性	说明
Web 界面	现代化 UI，直观易用
应用商店	一键安装数据库、OpenClash、AstrBot 等应用
Docker 管理	完整的容器编排和管理功能
终端访问	内置 Web 终端，直接操作服务器
计划任务	定时执行脚本、备份等任务
文件管理	在线文件编辑和管理
开源免费	社区版完全开源，无订阅费用

安装#

系统要求#

操作系统：主流 Linux 发行版（Ubuntu、CentOS、Debian 等）
内存：建议 2GB 以上
磁盘：建议 20GB 以上

一键安装#

官方文档

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

防火墙配置#

安装完成后，需要开放面板端口：

# Ubuntu/Debian (ufw)
ufw allow 20040/tcp

配置#

监听地址#

设置监听地址为 0.0.0.0 以允许外部访问：

配置路径：面板设置 → 安全设置
默认端口：20040

访问面板#

浏览器访问：http://服务器IP:20040

示例：http://172.18.122.71:20040

安全设置#

设置密码：首次访问时设置管理员密码
安全入口：建议启用安全入口，设置随机路径
SSL 配置：生产环境建议配置 HTTPS

功能模块#

应用商店#

一键安装各类应用，如数据库、OpenClash、AstrBot 等。

⚠️ 注意：应用使用 Docker 容器安装，如镜像拉取失败，请在「Docker 容器」中添加镜像源。

Docker 容器#

完整的 Docker 管理功能：

容器生命周期管理（启动、停止、重启、删除）
镜像管理（拉取、删除、镜像源配置）
容器编排和监控
日志查看

数据库#

简单数据库管理

终端#

内置 Web 终端，直接访问服务器命令行。

配置步骤： 1. 添加终端连接：root@127.0.0.1 2. SSH 需进行对应配置（允许 root 登录、密钥认证等）

计划任务#

定时执行各类任务：

系统备份
日志清理
脚本执行
数据库维护

文件管理#

在线文件管理功能：

文件浏览和编辑
上传下载
权限设置
压缩解压

日志查看#

实时查看系统日志、应用日志、容器日志。

常见问题#

Docker 镜像拉取失败#

原因：默认镜像源访问慢或不可达

解决： 1. 进入「Docker 容器」→「配置」 2. 添加国内镜像源（如阿里云、腾讯云）

snapd 安装的 Docker 不兼容#

问题：使用 snapd 安装的 Docker，环境变量有问题，应用无法安装

解决：使用 1Panel 内置脚本安装官方 Docker： 1. 进入「计划任务」→「脚本库」 2. 执行「安装 Docker」脚本

或手动安装官方 Docker：

curl -fsSL https://get.docker.com | sh

端口无法访问#

检查步骤： 1. 确认服务是否运行：systemctl status 1panel 2. 检查端口是否监听：netstat -tlnp | grep 20040 3. 检查防火墙规则 4. 检查云服务商安全组配置

面板忘记密码#

解决：通过命令行重置密码：

1pctl reset password