系统要求
兼容主流 Linux 发行版
支持 x86_64 和 ARM64 架构，最低 1GB 内存即可运行
操作系统
- Ubuntu 20.04 / 22.04 / 24.04
- CentOS 7 / 8 / Stream 9
- Debian 10 / 11 / 12
- Rocky Linux 8 / 9
- Alpine 3.18+
硬件配置
- CPU：1 核以上
- 内存：最低 1GB，推荐 2GB+
- 硬盘：最低 10GB，推荐 40GB+
- 网络：需可访问外网
支持架构
- x86_64 (amd64)
- ARM64 (aarch64)
- ARMv7 (armhf)
- 容器化部署（Docker）
方式一
一键安装脚本
最简单的安装方式，复制一行命令即可完成部署
1
以 root 身份登录服务器
使用 SSH 工具连接到您的 Linux 服务器
ssh root@your-server-ip
2
执行一键安装命令
根据您的系统选择对应的安装命令
Ubuntu / Debian
CentOS / Rocky
Alpine
curl -sS https://install.123mianban.com | bash
3
等待安装完成
安装过程约需 3-5 分钟，脚本将自动安装所有依赖并配置服务
4
访问面板
安装完成后，在浏览器中访问面板地址
http://服务器IP:8888
首次访问需设置管理员账号密码，请妥善保管。
方式二
Docker 部署
使用 Docker 快速部署，便于容器化管理和迁移
1
拉取最新镜像
docker pull 123mianban/panel:latest
2
创建数据卷
docker volume create 123mianban-data
3
运行容器
docker run -d \
--name 123mianban \
-p 8888:8888 \
-v 123mianban-data:/data \
--restart=always \
123mianban/panel:latest
4
访问面板
http://服务器IP:8888
Docker 部署提示
- 数据持久化：使用数据卷存储配置和数据，容器重建后数据不丢失
- 端口映射：默认映射 8888 端口，可按需修改
- 自动重启：
--restart=always确保服务随系统启动 - 镜像更新：定期拉取最新镜像获取功能更新和安全修复
方式三
源码构建
适合开发者或需要深度定制的场景
1
克隆源码
git clone https://github.com/123mianban/123mianban.git
2
安装依赖并构建
cd 123mianban && make build
3
启动服务
./bin/123mianban server start
常见问题
安装相关 FAQ
安装失败怎么办？
请检查以下几点：
- 确保以 root 用户身份执行安装命令
- 检查服务器网络是否正常，能否访问外网
- 确认系统版本在支持列表中
- 查看安装日志获取详细错误信息
如仍无法解决，请通过 工单系统 提交问题，我们的技术团队将协助排查。
如何升级到新版本？
一键安装的用户可直接执行：
curl -sS https://install.123mianban.com/update | bash
Docker 用户拉取新镜像后重建容器即可。升级前建议备份数据。
如何卸载 123面板？
curl -sS https://install.123mianban.com/uninstall | bash
卸载将停止并移除面板服务，数据目录可选择保留或删除。
面板默认端口是多少？如何修改？
默认端口为 8888。修改方式：
# 编辑配置文件
vi /opt/123mianban/config/app.conf
# 修改端口号后重启服务
systemctl restart 123mianban
是否支持离线安装？
支持。您可以在有网络的环境下载安装包，然后传输到目标服务器进行离线安装。详细步骤请参考 文档中心 的离线安装指南。