acepanel/acepanel.github.io
2
0
Fork 0
mirror of https://github.com/acepanel/acepanel.github.io.git synced 2026-02-04 10:17:13 +08:00
Code Issues Activity

feat: 更新文档

Browse Source
This commit is contained in:
耗子
2026-01-26 07:23:43 +08:00
parent 481831d896
commit ad66d1a8db
158 changed files with 5532 additions and 475 deletions
Download Patch File Download Diff File Expand all files Collapse all files

91
en/quickstart/cli.md
View File

@@ -1,46 +1,57 @@
AcePanel 提供了命令行工具，方便用户在无法访问 Web 界面时进行基本的面板管理操作。
# 命令行工具
## Managing Panel Service
AcePanel 提供命令行工具 `acepanel`，用于在无法访问 Web 界面时进行面板管理。
Do not stop or restart AcePanel while background tasks are still running, as this may cause task stuck or data loss.
## 服务管理
* Start Panel: `acepanel start`
* Stop Panel: `acepanel stop`
* Restart Panel: `acepanel restart`
::: warning 注意
后台任务运行时请勿停止或重启面板，可能导致任务中断或数据丢失。
:::
## Panel Command Line
下表列出了常用的 AcePanel 命令行工具命令：
| Command | Description |
|--------------------------------------------------------|------------------------------------------------------------------------------|
| `acepanel status` | Get the current status of the AcePanel service |
| `acepanel start` | Start the AcePanel service |
| `acepanel stop` | Stop the AcePanel service |
| `acepanel restart` | Restart the AcePanel service |
| `acepanel update` | Update AcePanel to the latest version |
| `acepanel sync` | Sync AcePanel cached data with cloud |
| `acepanel fix` | Fix AcePanel upgrade issues |
| `acepanel info` | Output AcePanel basic information and generate new password |
| `acepanel user list` | List all users |
| `acepanel user username <old_username> <new_username>` | Change a user's username |
| `acepanel user password <username> <new_password>` | Change a user's password |
| `acepanel user 2fa <username>` | Toggle two-factor authentication for a user |
| `acepanel https <on/off>` | Enable or disable HTTPS for AcePanel |
| `acepanel https generate` | Obtain a free certificate or generate a self-signed certificate for AcePanel |
| `acepanel entrance <on/off>` | Enable or disable the AcePanel access entrance |
| `acepanel bind-domain off` | Disable domain binding for AcePanel |
| `acepanel bind-ip off` | Disable IP binding for AcePanel |
| `acepanel bind-ua off` | Disable User-Agent binding for AcePanel |
| `acepanel port <new_port>` | Change the AcePanel listening port |
| `acepanel sync-time ` | Sync server time with NTP |
| `acepanel clear-task` | Clear all tasks in the task queue if they are stuck |
| `acepanel help` | Display help information for AcePanel commands |
For example, to change a user's password, you can use:
```bash
acepanel user password haozi 123456
```shell
acepanel start # 启动
acepanel stop # 停止
acepanel restart # 重启
acepanel status # 查看状态
```
This will change the password for the user `haozi` to `123456`.
## 用户管理
```shell
acepanel user list # 列出所有用户
acepanel user username <旧用户名> <新用户名> # 修改用户名
acepanel user password <用户名> <新密码> # 修改密码
acepanel user 2fa <用户名> # 开关两步验证
```
## 安全设置
```shell
acepanel https on|off # 开关 HTTPS
acepanel https generate # 生成证书（自签名或 Let's Encrypt）
acepanel entrance on|off # 开关安全入口
acepanel port <端口号> # 修改监听端口
acepanel bind-domain off # 解除域名绑定
acepanel bind-ip off # 解除 IP 绑定
acepanel bind-ua off # 解除 UA 绑定
```
## 维护命令
```shell
acepanel update # 更新面板
acepanel fix # 修复更新问题
acepanel sync # 同步缓存数据
acepanel sync-time # 同步服务器时间
acepanel clear-task # 清空任务队列
acepanel info # 查看面板信息并重置密码
acepanel help # 帮助
```
## 示例
修改用户 `admin` 的密码为 `newpassword`：
```shell
acepanel user password admin newpassword
```

63
en/quickstart/first-container.md
View File

@@ -1,42 +1,45 @@
以下演示如何在 AcePanel 使用 Docker 快速部署一个 pgAdmin 4 PostgreSQL 管理工具容器。
# 第一个容器：部署 pgAdmin 4
## 前提条件
本文以 pgAdmin 4 为例，演示如何通过 AcePanel 快速部署 Docker 容器。
- 已安装并运行 AcePanel 面板
## 安装 Docker
## 步骤 1：登录面板
进入「应用」页面，在「原生应用」中找到 Docker 并安装。安装进度可在「任务」页面查看。
使用浏览器访问 AcePanel 面板的地址，输入管理员账号和密码登录。
::: tip 国内服务器
国内服务器拉取镜像较慢，建议配置 [毫秒镜像](https://1ms.run/) 提供的付费加速源。
:::
## 步骤 2：安装 Docker
## 部署容器
1. 在面板左侧导航栏中，点击「应用」。
2. 在「原生应用」列表中，找到并安装 Docker。
3. 安装中可前往「任务」页面查看进度。
4. 安装完成后，确保 Docker 服务已启动。
5. （可选）对于国内服务器，建议配置毫秒镜像提供的付费源以提升下载速度。可前往[官网](https://1ms.run/)获取相关信息。
进入「应用」->「容器模板」，找到 pgAdmin 4，点击「部署」。
## 步骤 3：创建 pgAdmin 4 编排
![容器模板列表](/images/quickstart/container-template.png)
1. 在面板左侧导航栏中，点击「应用」。
2. 切换到「容器编排」标签页。
3. 在页面找到「pgAdmin 4」编排模板，点击「部署」按钮。
4. 弹窗中选择创建新编排并填写以下信息：
- **编排名称**：（可选）自行起一个编排名称（例如 `my-pgadmin4`）。
- **自动启动**：启用此项以在编排创建完成后自动启动容器。
- **自动防火墙**：启用此项以自动添加系统防火墙规则开放对应端口。
- **访问端口**：将容器的 `80` 端口映射到主机的某个未被占用的端口（例如 `999`）。
- **管理员邮箱**：填写用于登录 pgAdmin 4 的管理员邮箱地址。
- **管理员密码**：填写用于登录 pgAdmin 4 的管理员密码。
5. 点击「下一步」按钮，进入预览页面，可在此对编排配置进行最终确认与调整。
6. 确认无误后点击「创建」按钮，完成编排创建。
![部署1](/images/quickstart/container-deploy-step1.png)
## 步骤 4：等待容器下载与启动
选择「创建新编排」后填写配置：
若启用了「自动启动」选项，编排创建完成后容器将自动弹窗显示下载与启动进度。若未启用此选项，可前往「容器」->「编排」页面手动启动容器。
![部署2](/images/quickstart/container-deploy-step2.png)
## 步骤 5：访问 pgAdmin 4 服务
- **编排名称**：给编排起个名字，如 `pg4admin`
- **自动启动**：勾选后创建完成自动拉取镜像并启动
- **自动防火墙**：勾选后自动放行端口
- **访问端口**：容器 80 端口映射到主机端口，如 `999`
- **管理员邮箱/密码**：pgAdmin 4 的登录凭据
1. 容器启动完成后，使用浏览器访问 `http://服务器IP:映射端口`（例如 `http://x.x.x.x:999`）。
2. 在登录页面输入之前设置的管理员邮箱和密码，点击「登录」按钮进入 pgAdmin 4 后台管理界面。
3. 恭喜！您已成功使用 AcePanel 部署了 pgAdmin 4 容器。
点击「下一步」预览编排配置，确认后点击「创建」。
## 等待启动
如果勾选了「自动启动」，创建后会弹窗显示拉取和启动进度：
![启动进度](/images/container/compose-starting.png)
也可以在「容器」->「编排」页面手动管理：
![编排列表](/images/container/compose-list.png)
## 访问服务
启动完成后，浏览器访问 `http://服务器IP:端口`（如 `http://x.x.x.x:999`），用之前设置的邮箱和密码登录即可。

74
en/quickstart/first-project.md
View File

@@ -0,0 +1,74 @@
# 第一个项目：部署 Node.js 应用
本文以一个简单的 Node.js HTTP 服务为例，演示如何通过 AcePanel 部署和管理项目。
## 准备代码
先准备一个简单的 Node.js 应用。在项目目录创建 `app.js`：
```javascript
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'text/plain' });
res.end('Hello from AcePanel!\n');
});
server.listen(3000, () => {
console.log('Server running at http://localhost:3000/');
});
```
## 创建项目
进入「项目」页面，点击「创建项目」。
![创建项目](/images/quickstart/project-create.png)
填写配置：
- **项目名**：项目标识，如 `hello-node`
- **项目目录**：留空使用默认路径
- **运行用户**：一般选 `www`
- **启动命令**：`node app.js`
- **反向代理**：如需通过域名访问，可开启自动创建反向代理
## 上传代码
项目创建后，进入「文件」页面，导航到项目目录（如 `/opt/ace/projects/hello-node`），上传 `app.js` 文件。
也可以通过终端用 git clone 拉取代码。
## 配置项目
在项目列表点击「编辑」，可以调整更多设置：
![项目编辑](/images/quickstart/project-edit-run.png)
**运行设置**：
- **预启动命令**：启动前执行，如 `npm install`
- **重启策略**：进程异常退出时的处理方式
- **环境变量**：设置 `NODE_ENV=production` 等
**依赖**：可以关联 Node.js 运行环境版本。
## 启动项目
回到项目列表，点击「启动」按钮。
![项目列表](/images/quickstart/project-list.png)
启动后可点击「日志」查看输出，确认服务正常运行。
## 访问服务
如果开启了反向代理，通过配置的域名访问即可。
如果没有，可以通过 `http://服务器IP:3000` 直接访问（需在防火墙放行 3000 端口）。
::: tip 生产环境
生产环境建议：
- 开启「自启动」，服务器重启后自动恢复
- 配置反向代理，通过 Nginx 转发请求
- 在「资源限制」中设置内存上限，防止内存泄漏
:::

78
en/quickstart/first-website.md
View File

@@ -1,48 +1,52 @@
以下演示如何在 AcePanel 使用 Nginx + MySQL + PHP 快速部署一个 WordPress 博客网站。
# 第一个网站：部署 WordPress
## 前提条件
本文以 WordPress 为例，演示如何通过 AcePanel 快速搭建 PHP 网站。
- 已安装并运行 AcePanel 面板
- 已准备好 WordPress 安装包（可从 [WordPress 官方网站](https://wordpress.org/download/) 下载）
## 安装环境
## 步骤 1：登录面板
进入「应用」页面：
使用浏览器访问 AcePanel 面板的地址，输入管理员账号和密码登录。
1. 在「原生应用」中安装 Nginx 和 MySQL（或 Percona/MariaDB）
2. 在「运行环境」中安装 PHP（建议 8.0+）
## 步骤 2：安装环境
安装进度可在「任务」页面查看。
1. 在面板左侧导航栏中，点击「应用」。
2. 在「原生应用」列表中，找到并安装 Nginx、Percona/MySQL/MariaDB。
3. 在「运行环境」列表中，安装所需版本的 PHP（建议使用 PHP 8.0 或更高版本）。
4. 环境安装中可前往「任务」页面查看进度，安装完成后确保各服务均已启动。
## 创建网站
## 步骤 3：创建网站
进入「网站」->「PHP」，点击「创建网站」。
1. 在面板左侧导航栏中，点击「网站」。
2. 点击「PHP」标签页，切换到 PHP 网站管理页面。
3. 点击页面的「创建网站」按钮。
4. 在弹出的对话框中，填写以下信息：
- **名称**：自行起一个网站名称（例如 `my-wordpress`），创建完成后不可修改。
- **域名**：输入您的域名（例如 `example.com`），若没有域名亦可直接输入服务器 IP 地址。
- **根目录**：选择网站根目录（可直接留空使用默认路径）。
- **PHP 版本**：选择刚才安装的 PHP 版本。
- **数据库**：选择「MySQL」并复制生成的数据库名称、用户名和密码备用。
5. 点击「创建」按钮，完成网站创建。
![创建网站](/images/quickstart/website-create.png)
## 步骤 4：上传 WordPress 安装包
填写配置：
1. 网站创建完成后，点击网站列表中的「目录」，进入文件管理页面。
2. 点击「上传」按钮，选择并上传之前下载的 WordPress 安装包（通常为 `.zip` 格式）。
3. 上传完成后，双击/右键上传的压缩包，点击「解压」按钮，将文件解压到当前目录。
4. 进入解压后的 `wordpress` 目录，Ctrl + A 全选所有文件，Ctrl + X 剪切，然后返回上级目录，Ctrl + V 粘贴所有文件到网站根目录。
5. 删除解压后的空文件夹和压缩包。
- **名称**：网站标识，如 `wordpress`，创建后不可改
- **域名**：你的域名，没有域名可填服务器 IP
- **根目录**：留空使用默认路径
- **PHP 版本**：选择刚安装的版本
- **数据库**：选择 MySQL，记下生成的数据库名、用户名、密码
## 步骤 5：配置 WordPress
1. 返回网站列表，点击「编辑」按钮，进入网站配置页面。
2. 在「伪静态」标签页中，选择预设的「wordpress」伪静态规则，点击「保存」。
3. （可选）在「HTTPS」标签页中，点击「一键签发证书」申请并启用免费的 Let's Encrypt SSL 证书。
4. 保存配置后，使用浏览器访问您的域名（例如 `http://example.com` 或 `https://example.com`），进入 WordPress 安装页面。
5. 按照页面提示，选择语言，填写网站标题、管理员用户名、密码、电子邮箱等信息。
6. 在数据库设置页面，填写之前创建网站时生成的数据库名称、用户名和密码，数据库主机填写 `localhost`，点击「提交」。
7. 完成安装后，使用管理员账号登录 WordPress 后台，开始管理和发布内容。
8. 恭喜！您已成功使用 AcePanel 部署了一个 WordPress 网站。
## 上传 WordPress
从 [WordPress 官网](https://wordpress.org/download/) 下载安装包。
在网站列表点击「目录」进入文件管理，上传压缩包并解压。进入 `wordpress` 目录，`Ctrl+A` 全选，`Ctrl+X` 剪切，返回上级目录 `Ctrl+V` 粘贴，把文件移到网站根目录。
## 配置伪静态
回到网站列表，点击「编辑」，切换到「伪静态」标签页，选择预设的 `wordpress` 规则并保存。
![伪静态配置](/images/quickstart/website-rewrite.png)
::: tip HTTPS
可在「HTTPS」标签页一键签发免费的 Let's Encrypt 证书。
:::
## 安装 WordPress
浏览器访问你的域名，按提示完成安装：
1. 选择语言
2. 填写站点信息（标题、管理员账号等）
3. 数据库配置：填入之前记下的数据库信息，主机填 `localhost`
安装完成后即可登录 WordPress 后台。

86
en/quickstart/install.md
View File

@@ -1,36 +1,76 @@
AcePanel supports the latest two stable releases of mainstream `amd64` and `arm64` architecture systems. Installation of the LNMP environment has been tested on all systems listed in the table below.
# 安装
It is recommended to use systems marked as **Recommended**. Unless there are special circumstances, it is not recommended to use systems marked as **Not Recommended**.
## 系统要求
For systems not listed in the table below, you can try installing on your own, but no free technical support will be provided.
- 架构：`amd64` / `arm64`
- 内存：≥ 512MB（建议 1GB 以上）
- 磁盘：≥ 10GB 可用空间
| System | Version | Note |
|------------------|---------|-----------------|
| AlmaLinux | 10 | Recommended |
| AlmaLinux | 9 | Supported |
| RockyLinux | 10 | Recommended |
| RockyLinux | 9 | Supported |
| CentOS Stream | 10 | Not Recommended |
| CentOS Stream | 9 | Not Recommended |
| Ubuntu | 24 | Recommended |
| Ubuntu | 22 | Supported |
| Debian | 13 | Recommended |
| Debian | 12 | Supported |
| OpenCloudOS | 9 | Supported |
| TencentOS Server | 4 | Supported |
## 支持的操作系统
As system versions continue to update, we may also terminate support for some overly outdated systems to ensure the robustness of the Panel.
| 系统 | 版本 | 状态 |
|------------------|----|-----|
| AlmaLinux | 10 | 推荐 |
| AlmaLinux | 9 | 支持 |
| RockyLinux | 10 | 推荐 |
| RockyLinux | 9 | 支持 |
| Debian | 13 | 推荐 |
| Debian | 12 | 支持 |
| Ubuntu | 24 | 推荐 |
| Ubuntu | 22 | 支持 |
| OpenCloudOS | 9 | 支持 |
| TencentOS Server | 4 | 支持 |
| CentOS Stream | 10 | 不推荐 |
| CentOS Stream | 9 | 不推荐 |
## Start Installation
未列出的系统可自行尝试安装，但不提供技术支持。
> If you need to mount partitions, please complete before installing the Panel. Directory migration is not supported after Panel installation.
## 安装前准备
**<span style="color: red;">AcePanel recommends using [LFCloud high-performance AMD EYPC server](https://www.dkdun.cn/aff/MQZZNVHQ) for installation.</span>**
- 使用纯净系统安装，避免与已有环境冲突
- 如需挂载数据盘，请在安装前完成，安装后不支持目录迁移
- 确保服务器能正常访问外网
Log in to the server as `root` user and run the following command to install the Panel:
## 开始安装
::: tip AcePanel 推荐使用
[林枫云高性能 AMD EYPC 服务器](https://www.dkdun.cn/aff/MQZZNVHQ) 服务器安装
:::
以 `root` 用户登录服务器，执行：
```shell
bash <(curl -sSLm 10 https://dl.acepanel.net/helper.sh)
```
Installation is usually completed within 2 minutes. Do not close the terminal during the installation process.
安装过程中请勿关闭终端。
## 安装完成
安装完成后，终端会输出面板访问地址和初始账号密码：
```
========================================
AcePanel 安装完成
用户名：xxxxxxxx
密码：xxxxxxxxxxxxxxxx
端口：xxxxx
入口：/xxxxxx
========================================
```
首次访问可能需在浏览器信任自签名证书。
## 常见问题
**无法访问面板**
检查云服务器安全组和防火墙设置，确保放行面板端口。
**忘记用户/密码/地址**
使用命令行工具一键重置：
```shell
acepanel info
```

52
en/quickstart/introduction.md
View File

@@ -1,38 +1,38 @@
AcePanel 是一款专业的服务器运维管理面板，致力于为用户提供简单、高效且安全的服务器管理解决方案。
# 产品介绍
## 产品优势
AcePanel 是一款开源的服务器运维管理面板。
1. 极低占用: Go 语言开发，安装包小，占用低，单文件运行，不会对系统性能造成影响
2. 低破坏性: 设计为尽可能减少对系统的额外修改，在同类产品中，我们对系统的修改最少
3. 追随时代: 整体设计走在时代前沿，对新系统兼容性好，在同类产品中处于领先地位
4. 高效运维: 功能完善，自定义能力强，既可快速部署小型网站，也可基于定制化需求部署复杂应用
5. 离线运行: 支持离线模式，甚至可以在部署完成后停止面板进程，不会对已有服务造成任何影响
6. 安全稳定: 面板采用业界多种技术保障本体安全性，已在我们的多个生产环境中长期稳定运行
7. 全面开源: 少有的全开源面板，您可以在遵守开源协议的前提下对面板自由修改、二次开发
8. 永久免费: 承诺面板本体未来不会引入任何收费/授权功能，永久免费使用
## 特性
## 产品功能
- **极低占用**：Go 语言开发，单文件运行，资源占用极低
- **低破坏性**：尽可能减少对系统的修改，同类产品中最少
- **追随时代**：对新系统兼容性好，技术栈保持更新
- **高效运维**：功能完善，自定义能力强，适用于简单到复杂的部署场景
- **离线运行**：支持离线模式，停止面板不影响已部署的服务
- **安全稳定**：多重安全机制，生产环境长期稳定运行
- **完整开源**：全部代码开源，可自由修改和二次开发
- **永久免费**：面板本体不会引入任何收费功能
#### 快速建站
## 功能
深度集成 Nginx、MySQL、PHP 等主流服务，一键部署 LNMP 环境，一键搭建反向代理，支持多版本共存切换。
**快速建站**
#### 高效管理
深度集成 Nginx、MySQL、PHP 等主流服务，一键部署 LNMP 环境，支持多版本共存。
提供类似 Windows 资源管理器的文件管理功能，全面支持快捷键操作，支持批量处理文件，支持在线编辑代码。
**文件管理**
#### 一键备份
类似 Windows 资源管理器的操作体验，支持快捷键、批量操作、在线编辑。
支持网站、数据库一键备份与恢复，支持定时备份与远程存储，保障数据安全。
**备份恢复**
## 与同类产品的对比
网站、数据库一键备份与恢复，支持定时备份和远程存储。
## 对比
| 特性 | AcePanel | 同类产品 1 | 同类产品 B |
|------|-----------------|-----------------------|-----------------------------|
| 用户界面 | 清爽的现代化设计 | 现代化设计 | 功能繁杂且广告较多 |
| 开源情况 | 完整开源，全自动化构建 | 仅开源非专业版部分 | 部分开源，提交记录不完整 |
| 性能优化 | 极其高效，单文件运行 | 需 core 及 agent 双倍资源占用 | 资源占用较高，优化差 |
| 系统支持 | 主流 Linux 发行版 | 主流 Linux 发行版 | 支持较多但兼容性各异 |
| 应用中心 | 原生应用 + 容器编排双重支持 | 仅支持容器编排 | 应用陈旧，更新缓慢 |
| 技术栈 | Go 1.25 + Vue 3 | Go 1.24 + Vue 3 | Python 3.7 + Vue 3 + jQuery |
| 特性 | AcePanel | 同类产品 1 | 同类产品 B |
|------|-----------------|------------------|-----------------------------|
| 用户界面 | 清爽现代 | 现代化设计 | 功能繁杂，广告较多 |
| 开源情况 | 完整开源 | 仅开源非专业版 | 部分开源，提交记录不完整 |
| 资源占用 | 极低，单文件运行 | core + agent 双进程 | 较高 |
| 应用中心 | 原生应用 + 容器编排 | 仅容器编排 | 应用陈旧，更新缓慢 |
| 技术栈 | Go 1.25 + Vue 3 | Go 1.24 + Vue 3 | Python 3.7 + Vue 3 + jQuery |

2
en/quickstart/news/acepanel-3-release.md
View File

@@ -1,3 +1,5 @@
# AcePanel 3.0 正式发布
好久不见，经过几次跳票延期，AcePanel 3.0 终于在 2026 年初完成开发，经过了约 3 个星期的内测，现在是时候发布了。
## 升级全新品牌名称 AcePanel

14
en/quickstart/uninstall.md
View File

@@ -1,7 +1,17 @@
您可以使用 AcePanel 的帮助工具卸载 AcePanel。
# 卸载
::: danger 警告
卸载前请备份所有数据，卸载后数据不可恢复。
:::
## 卸载步骤
1. 备份网站、数据库等重要数据
2. 在面板中卸载所有已安装的应用
3. 执行卸载命令：
```shell
bash <(curl -sSLm 10 https://dl.acepanel.net/helper.sh)
```
注意：在卸载面板之前，请务必提前备份所有数据并卸载所有面板应用。卸载后数据将**不可恢复**！
选择「卸载面板」选项完成卸载。

36
en/quickstart/upgrade.md
View File

@@ -1,31 +1,33 @@
升级面板有自动升级，手动升级和 SSH 升级三种方式，默认安装完成后面板已配置为每日自动升级，通常您无需手动操作即可保持面板为最新版本。
# 更新
## 自动升级
## 自动更新
AcePanel 默认开启自动升级功能，面板会在每天的 2 点左右自动检测更新并进行升级，升级过程中面板会短暂不可用（通常不超过 1 分钟），请您耐心等待。
面板默认开启自动更新，每天凌晨 2 点左右会自动检测并更新。更新期间面板短暂不可用（通常不超过 1 分钟）。
若您希望手动升级，可在面板「设置」->「安全」关闭并保存「自动升级」设置，然后使用手动升级或 SSH 升级方式进行升级。
关闭自动更新：「设置」->「安全」->「自动更新」。
## 手动升级
## 手动更新
您可以在面板「首页」点击右上角的「更新」按钮，若有新版本会弹出升级页面，点击「更新」按钮即可开始升级。
### Web 界面
升级过程中请勿刷新浏览器以及操作面板，升级完成后页面会自动刷新（通常不超过 1 分钟），若页面未自动刷新请手动刷新页面。
点击首页右上角「更新」按钮，有新版本时会弹出更新页面。
## SSH 升级
更新过程中请勿刷新浏览器或操作面板，完成后页面自动刷新。
您也可以通过 SSH 手动升级面板，适用于无法通过面板升级的情况或者面板无法访问的情况。
### 命令行
使用 SSH 登录到服务器，确保您以 root 用户或具有 sudo 权限的用户身份登录，然后执行以下命令：
```bash
```shell
acepanel update
```
升级过程中请勿关闭 SSH 连接，升级完成后会有提示信息。
适用于面板无法访问的情况。更新过程中请勿关闭终端。
## 升级注意事项
## 更新失败
1. 升级前请确保已备份重要数据，升级过程通常不会影响数据，但以防万一总是好的。
2. 若升级过程中遇到问题，请参考[常见问题](../faq/panel)或前往[社区发帖](https://tom.moe)联系支持获取帮助。
3. 升级完成后建议清除浏览器缓存以确保加载最新的前端资源。
如果更新后出现问题，尝试修复：
```shell
acepanel fix
```
仍有问题可到 [社区](https://tom.moe) 反馈。