+
+
+SSL 证书服务
+免费证书有效期仅 3 个月且需要频繁续签， 付费证书有效期一年，省心省力
+
+
+
+
+
+
+
+ DV 单域名证书
+适合单个网站使用
+ ¥1X
+ / 年
+
+
+
联系购买
+ ✓
+ 域名验证 (DV) 证书
+
+ ✓
+ 保护单个域名
+
+ ✓
+ 一年有效期
+
+ ✓
+ 国际认可品牌
+
+
+
+
+DV 泛域名证书
+一张证书保护所有子域名
+ ¥1XX
+ / 年
+
+
+
联系购买
+ ✓
+ 域名验证 (DV) 证书
+
+ ✓
+ 保护所有子域名 (*.domain.com)
+
+ ✓
+ 一年有效期
+
+ ✓
+ 国际认可品牌
+
+
+
+
+
diff --git a/zh_CN/faq/application.md b/zh_CN/faq/application.md
new file mode 100644
index 0000000..8c4ee3b
--- /dev/null
+++ b/zh_CN/faq/application.md
@@ -0,0 +1,73 @@
+# 应用常见问题
+
+## PHP 模块安装
+
+「应用」->「运行环境」->「PHP」->「管理」->「模块」，安装需要的模块。
+
+部分模块需要编译安装，耗时较长， 可在「任务」页面查看进度。
+
+## PHP 函数被禁用
+
+默认禁用了部分高危函数。 如需启用：
+
+「应用」->「运行环境」->「PHP」->「管理」->「配置」
+
+找到 `disable_functions`，删除需要启用的函数名。
+
+:::warning 安全提示
+`exec`、`shell_exec`、`system` 等函数有安全风险， 启用前需确认必要性。
+:::
+
+## Nginx 配置错误
+
+修改配置后 Nginx 无法启动，查看错误：
+
+```shell
+nginx -t
+```
+
+修复配置后重启：
+
+```shell
+systemctl restart nginx
+```
+
+## Supervisor 启动报错
+
+### EACCES 权限错误
+
+项目目录权限问题，确保目录所有者为 www：
+
+```shell
+chown -R www:www /opt/ace/projects/项目名
+```
+
+### 找不到 node/npm
+
+通过 nvm 安装的 Node.js 不在默认 PATH 中。
+
+「应用」->「Supervisor 管理器」->「管理」->「配置」，添加：
+
+```ini
+environment=PATH="/root/.nvm/versions/node/v24.0.0/bin:/usr/local/bin:/usr/bin:/bin"
+```
+
+版本号替换为实际安装的版本， 可通过 `whereis node` 查看路径。
+
+## 应用安装失败
+
+1. 检查网络连接
+2. 查看「任务」页面的错误信息
+3. 尝试「应用」页面点击「更新缓存」后重试
+
+## 应用无法卸载
+
+有依赖关系的应用需要先卸载依赖它的应用。
+
+如 phpMyAdmin 依赖 Nginx，需先卸载 phpMyAdmin。
+
+## 多版本 PHP 共存
+
+可同时安装多个 PHP 版本， 在创建网站时选择对应版本。
+
+已有网站切换版本：「编辑」->「基本设置」->「PHP 版本」。
diff --git a/zh_CN/faq/container.md b/zh_CN/faq/container.md
new file mode 100644
index 0000000..df199bf
--- /dev/null
+++ b/zh_CN/faq/container.md
@@ -0,0 +1,73 @@
+# 容器常见问题
+
+## 镜像拉取失败
+
+国内服务器无法连接 Docker Hub，需配置镜像加速。
+
+### Docker
+
+「应用」->「Docker」->「管理」->「配置」，添加：
+
+```json
+{
+ "registry-mirrors": [
+ "https://docker.1ms.run"
+ ]
+}
+```
+
+### Podman
+
+「应用」->「Podman」->「管理」->「Registry 配置」，末尾添加：
+
+```toml
+[[registry]]
+location = "docker.io"
+[[registry.mirror]]
+location = "docker.1ms.run"
+```
+
+镜像加速地址可使用 [毫秒镜像](https://1ms.run/) 或其他服务。
+
+## 编排启动失败
+
+1. 点击「日志」查看错误信息
+2. 常见原因：
+ - 端口被占用：修改映射端口
+ - 镜像拉取失败：配置镜像加速
+ - 配置错误：检查 docker-compose.yml 语法
+
+## 容器无法访问
+
+1. 检查容器是否运行：「容器」->「容器」列表查看状态
+2. 检查端口映射是否正确
+3. 检查防火墙是否放行映射的主机端口
+
+## 容器内无法访问外网
+
+检查 Docker 网络配置：
+
+```shell
+docker network ls
+docker network inspect bridge
+```
+
+## 数据持久化
+
+容器删除后数据会丢失。 使用卷挂载持久化数据：
+
+在编排配置中添加 volumes：
+
+```yaml
+volumes:
+ - ./data:/app/data
+```
+
+## 查看容器日志
+
+```shell
+docker logs 容器名或ID
+docker logs -f 容器名或ID # 实时查看
+```
+
+或在面板「容器」->「容器」列表点击「日志」。
diff --git a/zh_CN/faq/database.md b/zh_CN/faq/database.md
new file mode 100644
index 0000000..93e6ccc
--- /dev/null
+++ b/zh_CN/faq/database.md
@@ -0,0 +1,73 @@
+# 数据库常见问题
+
+## 忘记数据库密码
+
+### MySQL/MariaDB/Percona
+
+在面板「数据库」->「用户」中修改用户密码。
+
+如果忘记 root 密码，可前往「应用」->「MySQL/MariaDB/Percona」->「管理」中查看/重置。
+
+### PostgreSQL
+
+在面板「数据库」->「用户」中修改用户密码。
+
+如果忘记 postgres 用户密码，可前往「应用」->「PostgreSQL」->「管理」中查看/重置。
+
+## 远程连接数据库
+
+默认只允许本地连接。 如需远程连接：
+
+MySQL/MariaDB/Percona：
+
+1. 在「数据库」->「用户」中，新建一个用户主机为 `%`（允许所有 IP）或指定 IP 的用户
+2. 在防火墙放行数据库端口 3306
+
+PostgreSQL：
+
+1. 前往「应用」->「PostgreSQL」->「管理」中编辑主配置找到`listen_addresses`，取消注释并将其值改为 `'*'`
+2. 在同一页面编辑用户配置，添加一行：`host all 用户名 (IP地址/掩码/all) scram-sha-256` 并保存
+3. 重启 PostgreSQL 服务
+4. 在防火墙放行数据库端口 5432
+
+:::warning 安全提示
+不建议将数据库端口暴露到公网， 建议使用 SSH 隧道或 VPN 连接。
+:::
+
+## 连接被拒绝
+
+1. 检查数据库服务是否运行
+2. 检查用户权限和主机设置
+3. 检查连接地址：本地连接用 `localhost` 或 `127.0.0.1`
+
+## 导入大文件失败
+
+phpMyAdmin 有上传限制。 大文件建议用命令行导入：
+
+```shell
+mysql -u 用户名 -p 数据库名 < 文件.sql
+```
+
+或使用面板的文件管理上传后，在终端执行导入。
+
+## 数据库备份
+
+1. 「备份」->「创建备份」选择数据库
+2. 或使用命令行：
+
+```shell
+# MySQL
+mysqldump -u 用户名 -p 数据库名 > backup.sql
+
+# PostgreSQL
+pg_dump -U 用户名 数据库名 > backup.sql
+```
+
+## 字符集问题
+
+已有数据库修改字符集：
+
+```sql
+ALTER
+DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+```
diff --git a/zh_CN/faq/panel.md b/zh_CN/faq/panel.md
new file mode 100644
index 0000000..af5f233
--- /dev/null
+++ b/zh_CN/faq/panel.md
@@ -0,0 +1,99 @@
+# 面板常见问题
+
+## 面板打不开
+
+SSH 登录服务器，检查面板状态：
+
+```shell
+acepanel status
+```
+
+如果服务已停止，启动它：
+
+```shell
+acepanel start
+```
+
+如果无法启动，尝试修复：
+
+```shell
+acepanel fix && acepanel update
+```
+
+服务正常但仍无法访问，检查防火墙：
+
+```shell
+# 检查端口是否监听
+curl -I http://127.0.0.1:面板端口/
+
+# 放行端口（firewalld）
+firewall-cmd --add-port=面板端口/tcp --permanent
+firewall-cmd --reload
+```
+
+云服务器还需检查安全组设置。
+
+查看面板日志排查问题：
+
+```shell
+journalctl -u acepanel -n 100
+```
+
+## 忘记密码/用户名/地址
+
+```shell
+acepanel info
+```
+
+输出面板地址、用户名，并生成新密码。
+
+## 修改面板端口
+
+```shell
+acepanel port 12345
+```
+
+修改后需在服务器安全组/防火墙放行新端口。
+
+## 关闭安全入口
+
+如果忘记安全入口路径：
+
+```shell
+acepanel entrance off
+```
+
+## 关闭域名/IP 绑定
+
+绑定后无法访问面板：
+
+```shell
+acepanel bind-domain off
+acepanel bind-ip off
+```
+
+## 关闭两步验证
+
+```shell
+acepanel user 2fa admin
+```
+
+## 证书错误
+
+面板默认使用自签名证书，浏览器会提示不安全， 点击「继续访问」即可。
+
+申请正式证书：
+
+```shell
+acepanel https generate
+```
+
+需要确保服务器 IP 80 端口可直接访问。
+
+## acepanel 命令无权限
+
+必须以 root 用户执行，或使用 sudo：
+
+```shell
+sudo acepanel status
+```
diff --git a/zh_CN/faq/project.md b/zh_CN/faq/project.md
new file mode 100644
index 0000000..55c2ad8
--- /dev/null
+++ b/zh_CN/faq/project.md
@@ -0,0 +1,68 @@
+# 项目常见问题
+
+## 项目启动失败
+
+点击「日志」查看错误信息。 常见原因：
+
+### 权限问题
+
+项目目录应在 `/opt/ace/projects/` 下，所有者为 www：
+
+```shell
+chown -R www:www /opt/ace/projects/项目名
+```
+
+如果部署在 `/root` 下，需使用 root 用户运行（不推荐）。
+
+### 找不到命令
+
+如 `node: No such file or directory`，说明环境变量未配置。
+
+解决方法：
+
+1. 在「编辑」->「依赖」中关联运行环境
+2. 或在「运行设置」->「环境变量」中添加 PATH
+
+### 端口被占用
+
+修改应用监听端口，或停止占用端口的进程：
+
+```shell
+lsof -i:3000 # 查看占用端口的进程
+```
+
+## 配置环境变量
+
+「编辑」->「运行设置」->「环境变量」，点击「添加」。
+
+常用配置：
+
+- `NODE_ENV=production`
+- `PORT=3000`
+
+## 预启动命令
+
+在项目启动前执行，如安装依赖：
+
+- Node.js：`npm install` 或 `yarn`
+- Python：`pip install -r requirements.txt`
+- Go：`go build`
+
+## 查看项目日志
+
+1. 面板：项目列表点击「日志」
+2. 命令行：`journalctl -u ace-project-项目名 -f`
+
+## 项目自动重启
+
+在「运行设置」中配置：
+
+- **重启策略**：失败时重启 / 总是重启 / 不重启
+- **重启间隔**：两次重启之间的等待时间
+- **最大重启次数**：防止无限重启
+
+## 反向代理配置
+
+创建项目时开启「反向代理」，会自动创建一个反向代理网站。
+
+手动配置：创建反向代理网站，上游地址填 `http://127.0.0.1:项目端口`。
diff --git a/zh_CN/faq/website.md b/zh_CN/faq/website.md
new file mode 100644
index 0000000..a513355
--- /dev/null
+++ b/zh_CN/faq/website.md
@@ -0,0 +1,80 @@
+# 网站常见问题
+
+## 网站无法访问
+
+1. 检查域名是否解析到服务器 IP
+2. 检查防火墙是否放行 80/443 端口
+3. 检查 Nginx 是否运行：「应用」->「Nginx」->「管理」
+4. 查看 Nginx 错误日志
+
+## 403 Forbidden
+
+通常是权限问题：
+
+```shell
+# 修复网站目录权限
+chown -R www:www /opt/ace/sites/网站名/public
+chmod -R 755 /opt/ace/sites/网站名/public
+```
+
+## 502 Bad Gateway
+
+PHP 网站出现 502，检查 PHP 是否运行：
+
+1. 「应用」->「运行环境」->「PHP」->「管理」
+2. 确认 PHP 版本与网站配置一致
+3. 查看 PHP 错误日志
+
+反向代理网站出现 502，检查后端服务是否运行。
+
+## 伪静态不生效
+
+1. 确认在「伪静态」标签页选择了正确的预设或填写了规则
+2. 点击「保存」后 Nginx 会自动重载
+3. 清除浏览器缓存后测试
+
+## 配置 QUIC (HTTP/3)
+
+面板支持 QUIC，但默认不添加 `Alt-Svc` 头。 在自定义配置中添加：
+
+```nginx
+add_header Alt-Svc 'h3=":$server_port"; ma=2592000';
+```
+
+确保服务器安全组/防火墙放行 UDP 443 端口。
+
+## 启用 TLSv1/TLSv1.1
+
+OpenSSL 3.x 默认禁用旧协议。 如必须使用，在「HTTPS」设置中修改密码套件：
+
+```nginx
+ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:AES128-SHA:AES256-SHA:DES-CBC3-SHA:@SECLEVEL=0;
+```
+
+## 启用 IPv6
+
+在「域名和监听」添加监听地址：`[::]:80` 和 `[::]:443`。
+
+## CDN 回源与 HTTPS
+
+| CDN 回源协议 | 网站 HTTPS 配置 |
+| -------- | ------------------- |
+| HTTP | 无需开启 |
+| HTTPS | 必须开启 |
+| 协议跟随 | 必须开启，且不能开启 HTTP 重定向 |
+
+## 上传文件大小限制
+
+默认限制 100MB。 修改 PHP 配置：
+
+1. 「应用」->「运行环境」->「PHP」->「管理」->「主配置」
+2. 修改 `upload_max_filesize` 和 `post_max_size`
+3. 保存后重启 PHP
+
+## SSL 证书申请失败
+
+1. 确认域名已解析到服务器
+2. 确认 80 端口可访问（Let's Encrypt 验证需要）
+3. 检查是否超过 Let's Encrypt 速率限制
+4. 尝试使用 DNS 验证方式
+5. 更换其他证书提供商
diff --git a/zh_CN/index.md b/zh_CN/index.md
new file mode 100644
index 0000000..c006157
--- /dev/null
+++ b/zh_CN/index.md
@@ -0,0 +1,65 @@
+---
+layout: home
+hero:
+ name: "AcePanel"
+ text: "简单轻量 • 高效运维"
+ tagline: 全能服务器运维管理面板
+ actions:
+ - theme: brand
+ text: 🌟 点亮 Star
+ link: https://github.com/acepanel/panel
+ target: _blank
+ - theme: alt
+ text: 快速安装
+ link: /quickstart/install
+features:
+ - icon: ✨
+ title: 极低占用
+ details: Go 语言开发，安装包小，占用低，单文件运行，不会对系统性能造成影响
+ - icon: 🛠
+ title: 低破坏性
+ details: 设计为尽可能减少对系统的额外修改，在同类产品中，我们对系统的修改最少
+ - icon: 📅
+ title: 追随时代
+ details: 整体设计走在时代前沿，对新系统兼容性好，在同类产品中处于领先地位
+ - icon: 🚀
+ title: 高效运维
+ details: 功能完善，自定义能力强，既可快速部署小型网站，也可基于定制化需求部署复杂应用
+ - icon: ⛓️💥
+ title: 离线运行
+ details: 支持离线模式，甚至可以在部署完成后停止面板进程，不会对已有服务造成任何影响
+ - icon: 🛡
+ title: 安全稳定
+ details: 面板采用业界多种技术保障本体安全性，已在我们的多个生产环境中长期稳定运行
+ - icon: 💽
+ title: 全面开源
+ details: 少有的全开源面板，您可以在遵守开源协议的前提下对面板自由修改、二次开发
+ - icon: 🆓
+ title: 永久免费
+ details: 承诺面板本体未来不会引入任何收费/授权功能，永久免费使用
+---
+
+## 合作伙伴
+
+
diff --git a/zh_CN/quickstart/cli.md b/zh_CN/quickstart/cli.md
new file mode 100644
index 0000000..b3c6c01
--- /dev/null
+++ b/zh_CN/quickstart/cli.md
@@ -0,0 +1,57 @@
+# 命令行工具
+
+AcePanel 提供命令行工具 `acepanel`，用于在无法访问 Web 界面时进行面板管理。
+
+## 服务管理
+
+:::warning 注意
+后台任务运行时请勿停止或重启面板，可能导致任务中断或数据丢失。
+:::
+
+```shell
+acepanel start # 启动
+acepanel stop # 停止
+acepanel restart # 重启
+acepanel status # 查看状态
+```
+
+## 用户管理
+
+```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
+```
diff --git a/zh_CN/quickstart/first-container.md b/zh_CN/quickstart/first-container.md
new file mode 100644
index 0000000..80ac363
--- /dev/null
+++ b/zh_CN/quickstart/first-container.md
@@ -0,0 +1,45 @@
+# 第一个容器：部署 pgAdmin 4
+
+本文以 pgAdmin 4 为例，演示如何通过 AcePanel 快速部署 Docker 容器。
+
+## 安装 Docker
+
+进入「应用」页面，在「原生应用」中找到 Docker 并安装。 安装进度可在「任务」页面查看。
+
+:::tip 国内服务器
+国内服务器拉取镜像较慢， 建议配置 [毫秒镜像](https://1ms.run/) 提供的付费加速源。
+:::
+
+## 部署容器
+
+进入「应用」->「容器模板」，找到 pgAdmin 4，点击「部署」。
+
+
+
+
+
+选择「创建新编排」后填写配置：
+
+
+
+- **编排名称**：给编排起个名字，如 `pg4admin`
+- **自动启动**：勾选后创建完成自动拉取镜像并启动
+- **自动防火墙**：勾选后自动放行端口
+- **访问端口**：容器 80 端口映射到主机端口，如 `999`
+- **管理员邮箱/密码**：pgAdmin 4 的登录凭据
+
+点击「下一步」预览编排配置，确认后点击「创建」。
+
+## 等待启动
+
+如果勾选了「自动启动」，创建后会弹窗显示拉取和启动进度：
+
+
+
+也可以在「容器」->「编排」页面手动管理：
+
+
+
+## 访问服务
+
+启动完成后，浏览器访问 `http://服务器IP:端口`（如 `http://x.x.x.x:999`），用之前设置的邮箱和密码登录即可。
diff --git a/zh_CN/quickstart/first-project.md b/zh_CN/quickstart/first-project.md
new file mode 100644
index 0000000..7e4f8e7
--- /dev/null
+++ b/zh_CN/quickstart/first-project.md
@@ -0,0 +1,76 @@
+# 第一个项目：部署 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/');
+});
+```
+
+## 创建项目
+
+进入「项目」页面，点击「创建项目」。
+
+
+
+填写配置：
+
+- **项目名**：项目标识，如 `hello-node`
+- **项目目录**：留空使用默认路径
+- **运行用户**：一般选 `www`
+- **启动命令**：`node app.js`
+- **反向代理**：如需通过域名访问，可开启自动创建反向代理
+
+## 上传代码
+
+项目创建后，进入「文件」页面，导航到项目目录（如 `/opt/ace/projects/hello-node`），上传 `app.js` 文件。
+
+也可以通过终端用 git clone 拉取代码。
+
+## 配置项目
+
+在项目列表点击「编辑」，可以调整更多设置：
+
+
+
+**运行设置**：
+
+- **预启动命令**：启动前执行，如 `npm install`
+- **重启策略**：进程异常退出时的处理方式
+- **环境变量**：设置 `NODE_ENV=production` 等
+
+**依赖**：可以关联 Node.js 运行环境版本。
+
+## 启动项目
+
+回到项目列表，点击「启动」按钮。
+
+
+
+启动后可点击「日志」查看输出，确认服务正常运行。
+
+## 访问服务
+
+如果开启了反向代理，通过配置的域名访问即可。
+
+如果没有，可以通过 `http://服务器IP:3000` 直接访问（需在防火墙放行 3000 端口）。
+
+:::tip 生产环境
+生产环境建议：
+
+- 开启「自启动」，服务器重启后自动恢复
+- 配置反向代理，通过 Nginx 转发请求
+- 在「资源限制」中设置内存上限，防止内存泄漏
+ :::
diff --git a/zh_CN/quickstart/first-website.md b/zh_CN/quickstart/first-website.md
new file mode 100644
index 0000000..3a7ceae
--- /dev/null
+++ b/zh_CN/quickstart/first-website.md
@@ -0,0 +1,52 @@
+# 第一个网站：部署 WordPress
+
+本文以 WordPress 为例，演示如何通过 AcePanel 快速搭建 PHP 网站。
+
+## 安装环境
+
+进入「应用」页面：
+
+1. 在「原生应用」中安装 Nginx 和 Percona（或 MySQL/MariaDB）
+2. 在「运行环境」中安装 PHP（建议 8.3+）
+
+安装进度可在「任务」页面查看。
+
+## 创建网站
+
+进入「网站」->「PHP」，点击「创建网站」。
+
+
+
+填写配置：
+
+- **名称**：网站标识，如 `wordpress`，创建后不可改
+- **域名**：你的域名，没有域名可填服务器 IP
+- **根目录**：留空使用默认路径
+- **PHP 版本**：选择刚安装的版本
+- **数据库**：选择 MySQL，记下生成的数据库名、用户名、密码
+
+## 上传 WordPress
+
+从 [WordPress 官网](https://wordpress.org/download/) 下载安装包。
+
+在网站列表点击「目录」进入文件管理，上传压缩包并解压。 进入 `wordpress` 目录，`Ctrl+A` 全选，`Ctrl+X` 剪切，返回上级目录 `Ctrl+V` 粘贴，把文件移到网站根目录。
+
+## 配置伪静态
+
+回到网站列表，点击「编辑」，切换到「伪静态」标签页，选择预设的 `wordpress` 规则并保存。
+
+
+
+:::tip HTTPS
+可在「HTTPS」标签页一键签发免费的 Let's Encrypt 证书。
+:::
+
+## 安装 WordPress
+
+浏览器访问你的域名，按提示完成安装：
+
+1. 选择语言
+2. 填写站点信息（标题、管理员账号等）
+3. 数据库配置：填入之前记下的数据库信息，主机填 `localhost`
+
+安装完成后即可登录 WordPress 后台。
diff --git a/zh_CN/quickstart/install.md b/zh_CN/quickstart/install.md
new file mode 100644
index 0000000..bfbab15
--- /dev/null
+++ b/zh_CN/quickstart/install.md
@@ -0,0 +1,76 @@
+# 安装
+
+## 系统要求
+
+- 架构：`amd64` / `arm64`
+- 内存：≥ 512MB（建议 1GB 以上）
+- 磁盘：≥ 10GB 可用空间
+
+## 支持的操作系统
+
+| 系统 | 版本 | 状态 |
+| ---------------- | -- | --- |
+| 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 | 不推荐 |
+
+未列出的系统可自行尝试安装，但不提供技术支持。
+
+## 安装前准备
+
+- 使用纯净系统安装，避免与已有环境冲突
+- 如需挂载数据盘，请在安装前完成，安装后不支持目录迁移
+- 确保服务器能正常访问外网
+
+## 开始安装
+
+:::tip AcePanel 推荐使用
+[林枫云高性能 AMD EYPC 服务器](https://www.dkdun.cn/aff/MQZZNVHQ) 服务器安装
+:::
+
+以 `root` 用户登录服务器，执行：
+
+```shell
+bash <(curl -sSLm 10 https://dl.acepanel.net/helper.sh)
+```
+
+安装过程中请勿关闭终端。
+
+## 安装完成
+
+安装完成后，终端会输出面板访问地址和初始账号密码：
+
+```
+========================================
+AcePanel 安装完成
+用户名：xxxxxxxx
+密码：xxxxxxxxxxxxxxxx
+端口：xxxxx
+入口：/xxxxxx
+========================================
+```
+
+首次访问可能需在浏览器信任自签名证书。
+
+## 常见问题
+
+**无法访问面板**
+
+检查云服务器安全组和防火墙设置，确保放行面板端口。
+
+**忘记用户/密码/地址**
+
+使用命令行工具一键重置：
+
+```shell
+acepanel info
+```
diff --git a/zh_CN/quickstart/introduction.md b/zh_CN/quickstart/introduction.md
new file mode 100644
index 0000000..8cf0232
--- /dev/null
+++ b/zh_CN/quickstart/introduction.md
@@ -0,0 +1,38 @@
+# 产品介绍
+
+AcePanel 是一款开源的服务器运维管理面板。
+
+## 特性
+
+- **极低占用**：Go 语言开发，单文件运行，资源占用极低
+- **低破坏性**：尽可能减少对系统的修改，同类产品中最少
+- **追随时代**：对新系统兼容性好，技术栈保持更新
+- **高效运维**：功能完善，自定义能力强，适用于简单到复杂的部署场景
+- **离线运行**：支持离线模式，停止面板不影响已部署的服务
+- **安全稳定**：多重安全机制，生产环境长期稳定运行
+- **完整开源**：全部代码开源，可自由修改和二次开发
+- **永久免费**：面板本体不会引入任何收费功能
+
+## 功能
+
+**快速建站**
+
+深度集成 Nginx、MySQL、PHP 等主流服务，一键部署 LNMP 环境，支持多版本共存。
+
+**文件管理**
+
+类似 Windows 资源管理器的操作体验，支持快捷键、批量操作、在线编辑。
+
+**备份恢复**
+
+网站、数据库一键备份与恢复，支持定时备份和远程存储。
+
+## 对比
+
+| 特性 | AcePanel | 同类产品 1 | 同类产品 B |
+| ---- | ------------------------------- | ------------------------------- | ------------------------------------------- |
+| 用户界面 | 清爽现代 | 现代化设计 | 功能繁杂，广告较多 |
+| 开源情况 | 完整开源 | 仅开源非专业版 | 部分开源，提交记录不完整 |
+| 资源占用 | 极低，单文件运行 | core + agent 双进程 | 较高 |
+| 应用中心 | 原生应用 + 容器编排 | 仅容器编排 | 应用陈旧，更新缓慢 |
+| 技术栈 | Go 1.25 + Vue 3 | Go 1.24 + Vue 3 | Python 3.7 + Vue 3 + jQuery |
diff --git a/zh_CN/quickstart/news/acepanel-3-release.md b/zh_CN/quickstart/news/acepanel-3-release.md
new file mode 100644
index 0000000..eb48bbb
--- /dev/null
+++ b/zh_CN/quickstart/news/acepanel-3-release.md
@@ -0,0 +1,167 @@
+# AcePanel 3.0 正式发布
+
+好久不见， 经过几次跳票延期，AcePanel 3.0 终于在 2026 年初完成开发， 经过了约 3 个星期的内测，现在是时候发布了。
+
+## 升级全新品牌名称 AcePanel
+
+AcePanel 原名耗子面板，是本人 2022 年底开发的服务器运维管理面板。
+
+之前收到最多的一个反馈就是耗子面板这个名字不好听，于是我们现在换了更高端大气上档次的名字 - AcePanel，你也可以叫它王牌面板/艾斯面板。
+
+
+
+本文以下 AcePanel 均表示 AcePanel 3.0 版本
+
+## 支持运行环境与项目管理
+
+AcePanel 这次最大的更新就是新增了运行环境功能，支持一键安装与管理 Go、Java、Node.js、PHP、Python 等运行环境，支持多版本同时共存。
+
+
+
+同时 AcePanel 基于 Linux systemd 的强大能力全新开发了项目管理功能，支持通过安装的运行环境一键创建与管理各类 Web 项目和常驻程序，可平替 PM2、Supervisor 等工具。
+
+
+
+
+
+## 网站管理重构
+
+AcePanel 还对网站管理功能进行了重构，重新组织了网站目录结构，支持反向代理、纯静态、PHP 3 种网站类型，并新增了多项常用配置以及自定义功能。
+
+
+
+
+
+新的网站目录结构允许灵活添加各种自定义配置，且不易冲突。
+
+## 应用中心优化
+
+AcePanel 正式上线期待已久的容器编排模版功能，支持一键部署 WordPress、Nextcloud、GitLab 等常用程序。
+
+
+
+（缺少你想要的程序？ 欢迎向 AcePanel 模版库提交 PR，方式可见文末）
+
+AcePanel 在原有 OpenResty 与 Percona 的基础上新增 Nginx 与 MySQL、MariaDB，同时还优化了许多应用的安装流程以提高安装速度， 特别对 Percona/MySQL/MariaDB 为常用系统使用预制安装包以极大提高安装速度和成功率。
+
+（实测 MySQL 通常可以在 2 分钟内完成安装）
+
+## 备份优化
+
+AcePanel 优化了备份功能，新增备份存储设置，支持添加 S3、SFTP 等常用远程存储。
+
+（你可能会问为什么没有 OSS、COS？ 这是因为 OSS、COS 等均提供 S3 兼容接口，可直接使用 S3 配置，因此没必要单独为它们引入依赖以及额外开发。）
+
+
+
+## 全新的面板助手
+
+AcePanel 使用 Go 语言重写了原来基于 shell 脚本的安装器， 新的面板助手全面支持交互式安装及多语言，提供更好、更现代的用户体验。
+
+
+
+## 使用优化
+
+AcePanel 全面优化了文件管理，还原类似 Windows 资源管理器的操作体验（支持快捷键操作）。
+
+
+
+
+
+基于 Monaco 开发全新的文件编辑器，即是编辑器，亦可作为在线 IDE 使用（同样支持快捷键操作）。
+
+
+
+工具箱能力全面提升， 进程管理支持右键操作，同时新增 SSH 服务管理，磁盘管理，日志清理以及 Web 钩子等功能。
+
+
+
+
+
+
+
+计划任务周期选择器重写，提供更友好的交互体验。
+
+
+
+## 其他优化
+
+- 支持使用 ACME 申请 Let's Encrypt IP 证书
+- 入口错误页支持自定义
+- 登录支持自动开启验证码
+- 自定义 Logo 与隐藏菜单支持长期保存
+- 新增操作日志记录与查看功能
+- 证书管理新增 ACME ARI 支持
+- 图标全面本地化，不再需要依赖外部 CDN
+- Nginx/OpenResty 新增 Stream 支持（四层代理）
+- 新增 PHP 8.5 支持
+- 新增 Apache Web 服务器基础支持
+- 新增 LiteSSL 证书支持
+- 容器与编排创建/启动支持实时显示进度
+- 容器支持一键进入终端
+- 资源监控支持自定义时间范围与网卡/磁盘选择
+- 首页应用支持拖拽排序
+- 文件管理支持大文件分片上传
+- 文件管理支持压缩包双击解压
+- 应用与运行环境、容器模版支持分类筛选
+- SSH 终端支持私钥登录
+- 系统工具箱 - DNS 适配现代网络管理方式
+- 支持可视化修改 Docker 基本设置
+- 数据库服务器列表支持一键进入终端
+- 部分删除操作新增 5s 倒计时确认
+
+## 问题修复
+
+- 修复登录超过 120 分钟后面板自动登出的问题
+- 修复 Docker 29+ 版本无法使用面板容器功能的问题
+- 修复面板偶现 ERR_CONNECTION_REFUSED 错误的问题
+- 修复面板 Websocket 会话存在资源泄露的问题
+- 修复部分情况下防火墙端口放行不生效的问题
+- 修复 PHP 设置默认 cli 版本不生效的问题
+- 修复 rsync secrets 换行符写入不正确的问题
+- 修复 fail2ban IPv6 地址显示和解封问题
+- 其他已知问题修复
+
+## 兼容性变化
+
+鉴于 openEuler 及 Alibaba Cloud Linux 4 和 Anolis 23 等新版信创系统把软件源改的面目全非，适配极其困难，因此 AcePanel 3.0 决定放弃对这三个发行版的支持。 建议切换到 AlmaLinux / Rocky Linux 使用， 如必须使用信创系统可考虑 OpenCloudOS 9 或 TencentOS Server 4。
+
+同时 AcePanel 3.0 版本起，不再支持基于 4.x 内核的 RHEL 8-based 系统（AlmaLinux 8/Rocky Linux 8）， 请升级至 9.x/10.x 使用。
+
+其次为支持预制安装包以解决饱受诟病的 MySQL 编译慢问题，AcePanel 修改了默认安装目录为 `/opt/ace` 且不再允许自定义（预计影响不大，仍可在安装前挂载数据盘）。
+
+## 关于旧版本升级及维护
+
+计划在 AcePanel 3.0 稳定一段时间之后推出旧版耗子面板 2.x 升级至 AcePanel 3.0 的脚本， 鉴于改动较大，预计无法实现完美升级，请留意。
+
+旧版耗子面板 2.x 仍将继续维护一段时间的安全更新（预计到 2026 年底）， 您可在此期间自行安排时间点进行升级。
+
+## 开源协议变化
+
+新版本 AcePanel 决定使用更宽松的开源协议 BSD-3，希望未来能有更多的开发者参与进来，一起打造更好用的服务器面板。
+
+当前可参与贡献的项目如下：
+
+- [AcePanel 主程序（求star）](https://github.com/acepanel/panel)
+- [AcePanel 安装器](https://github.com/acepanel/helper)
+- [AcePanel 容器模版库](https://github.com/acepanel/templates)
+- [AcePanel 文档](https://github.com/acepanel/acepanel.github.io)
+- [AcePanel 翻译](https://zh.crowdin.com/project/acepanel)
+
+不会代码？ 没关系，欢迎发表使用 AcePanel 搭建各种服务、发掘不同玩法的文章，帮助推广 AcePanel。
+
+## 结束语
+
+写这篇文章的时候是夜里 4 点多， 转眼这个项目已经在上个月度过其 3 岁生日， 当年写下第一行代码时我还对 Go 一窍不通，如今已经成长为有些人口中的大佬。
+
+AcePanel 是我的青春， 我希望将其写到极致而不留遗憾，因此来回重构了数次， 如果因此影响了您的使用，我在此说声道歉。 现在自己年纪也慢慢大了，加上工作与生活的琐事繁多，未来再想重构也不一定折腾得动了。
+
+2026 年的 AI 已经非常强大， AcePanel 新版本中有大量复杂的交互逻辑均使用 Claude Opus 4.5 辅助开发， 我承认以我的水平难以写出这样完善的交互。 也许继续发展下去未来或将不再需要面板，而是直接对 AI 说：帮我安装 Nginx；帮我创建 xxx 项目。 谁知道呢？
+
+最后，感谢赞助商微晓朵和林枫云以及参与 AcePanel 内测的所有用户， 没有你们的帮助 AcePanel 将难以如期发布。
+
+附上 AcePanel 新版本的安装命令，欢迎测试体验：
+
+```bash
+bash <(curl -sSLm 10 https://dl.acepanel.net/helper.sh)
+```
diff --git a/zh_CN/quickstart/uninstall.md b/zh_CN/quickstart/uninstall.md
new file mode 100644
index 0000000..3c91f8a
--- /dev/null
+++ b/zh_CN/quickstart/uninstall.md
@@ -0,0 +1,17 @@
+# 卸载
+
+:::danger 警告
+卸载前请备份所有数据， 卸载后数据不可恢复。
+:::
+
+## 卸载步骤
+
+1. 备份网站、数据库等重要数据
+2. 在面板中卸载所有已安装的应用
+3. 执行卸载命令：
+
+```shell
+bash <(curl -sSLm 10 https://dl.acepanel.net/helper.sh)
+```
+
+选择「卸载面板」选项完成卸载。
diff --git a/zh_CN/quickstart/upgrade.md b/zh_CN/quickstart/upgrade.md
new file mode 100644
index 0000000..cb39a14
--- /dev/null
+++ b/zh_CN/quickstart/upgrade.md
@@ -0,0 +1,33 @@
+# 更新
+
+## 自动更新
+
+面板默认开启自动更新，每天凌晨 2 点左右会自动检测并更新。 更新期间面板会短暂不可用（通常不超过 1 分钟）。
+
+关闭自动更新：「设置」->「安全」->「自动更新」。
+
+## 手动更新
+
+### Web 界面
+
+点击首页右上角「更新」按钮， 有新版本时会弹出更新页面。
+
+更新过程中请勿刷新浏览器或操作面板， 完成后页面会自动刷新。
+
+### 命令行
+
+```shell
+acepanel update
+```
+
+适用于面板无法访问的情况。 更新过程中请勿关闭终端。
+
+## 更新失败
+
+如果更新后出现问题，尝试修复：
+
+```shell
+acepanel fix
+```
+
+仍有问题可到 [社区](https://tom.moe) 反馈。
diff --git a/zh_CN/support.md b/zh_CN/support.md
new file mode 100644
index 0000000..8d5296b
--- /dev/null
+++ b/zh_CN/support.md
@@ -0,0 +1,37 @@
+---
+sidebar: false
+prev: false
+next: false
+---
+
+# 支持
+
+## 免费论坛服务
+
+我们提供免费的论坛服务，您可以在论坛中提问、交流、分享面板使用中的问题。
+
+- [Moe Tom](https://tom.moe/c/technical/acepanel)
+
+## 付费远程服务
+
+网站报错、速度慢、被挂马？ 服务器资源占用高、配置调优、入侵朔源？ 我们统统一站式服务。
+
+### 远程服务价格表
+
+远程服务是指我们通过远程协助的方式，帮助您解决问题。
+
+| 名称 | 介绍 | 价格 |
+| ---- | ---------------- | ----- |
+| 单次服务 | 仅限一次服务，问题解决服务即结束 | ￥50 起 |
+
+### 服务流程
+
+1. 提前联系我们，说明问题
+2. 我们评估问题，确认是否可以解决及给出预估价格
+3. 您确认价格后，支付 50% 预付款，服务开始
+4. 服务完成后，您确认无误并支付剩余款项
+
+## 联系我们
+
+- [企业微信](https://work.weixin.qq.com/kfid/kfc20ea8e38b5a4e73a)
+- [QQ 826896000](https://wpa.qq.com/msgrd?v=3&uin=826896000&site=qq&menu=yes)
diff --git a/zh_CN/version-[version].md b/zh_CN/version-[version].md
new file mode 100644
index 0000000..359bfd5
--- /dev/null
+++ b/zh_CN/version-[version].md
@@ -0,0 +1,8 @@
+# v{{ $params.version }}
+
+- 版本类型：{{ $params.type == 'stable' ? '稳定版' : '测试版' }}
+- 发布时间：{{ $params.time }}
+
+## 更新内容
+
+
diff --git a/zh_TW/about.md b/zh_TW/about.md
new file mode 100644
index 0000000..7272352
--- /dev/null
+++ b/zh_TW/about.md
@@ -0,0 +1,73 @@
+---
+sidebar: false
+prev: false
+next: false
+---
+
+
+
+# 關於
+
+AcePanel is a professional server operation and maintenance management panel dedicated to providing users with simple,
+efficient, and secure server management solutions.
+
+| 願景 | 使命 | 價值觀 |
+| ----------------- | ------------- | -------------- |
+| 成為領先的伺服器管理解決方案提供商 | 讓伺服器管理變得簡單而高效 | 用戶至上、創新驅動、專業專注 |
+
+## 團隊介紹
+
+为什么选择付费证书
+
+
+
+
+
+ 更长有效期
+一年有效期，无需频繁续签
+
+
+
+ 快速签发
+付款后快速完成签发
+
+
+
+ 国际品牌
+全球浏览器信任
+
+
+
+ 专业支持
+遇到问题随时咨询
+
+ 
+ 
+ 
+ 
+ 
+ 
+
+
+
+SSL Certificate Service
+Free certificates are only valid for 3 months and require frequent renewal. Paid certificates are valid for one year, saving you time and effort
+
+
+
+
+
+
+
+ DV Single Domain Certificate
+Suitable for a single website
+ ¥1X
+ / year
+
+
+
Contact to Purchase
+ ✓
+ Domain Validation (DV) Certificate
+
+ ✓
+ Protects a single domain
+
+ ✓
+ One year validity
+
+ ✓
+ Internationally recognized brand
+
+
+
+
+DV Wildcard Certificate
+One certificate protects all subdomains
+ ¥1XX
+ / year
+
+
+
Contact to Purchase
+ ✓
+ Domain Validation (DV) Certificate
+
+ ✓
+ Protects all subdomains (*.domain.com)
+
+ ✓
+ One year validity
+
+ ✓
+ Internationally recognized brand
+
+
+
+
+Why Choose Paid Certificates
+
+
+
+
+
+ Longer Validity
+One year validity, no frequent renewal needed
+
+
+
+ Fast Issuance
+Quick issuance after payment
+
+
+
+ International Brand
+Trusted by browsers worldwide
+
+
+
+ Professional Support
+Consult anytime when you have questions
+
+
diff --git a/zh_TW/faq/application.md b/zh_TW/faq/application.md
new file mode 100644
index 0000000..1afab1d
--- /dev/null
+++ b/zh_TW/faq/application.md
@@ -0,0 +1,73 @@
+# Application FAQ
+
+## PHP Module Installation
+
+**Apps** -> **Runtimes** -> **PHP** -> **Manage** -> **Modules**, install the required modules.
+
+Some modules require compilation and take longer to install. You can check the progress on the **Tasks** page.
+
+## PHP Functions Disabled
+
+Some high-risk functions are disabled by default. To enable them:
+
+**Apps** -> **Runtimes** -> **PHP** -> **Manage** -> **Configuration**
+
+Find `disable_functions` and remove the function names you want to enable.
+
+:::warning Security Warning
+Functions like `exec`, `shell_exec`, `system` have security risks. Please confirm necessity before enabling.
+:::
+
+## Nginx Configuration Error
+
+If Nginx fails to start after modifying configuration, check the error:
+
+```shell
+nginx -t
+```
+
+After fixing the configuration, restart:
+
+```shell
+systemctl restart nginx
+```
+
+## Supervisor Startup Error
+
+### EACCES Permission Error
+
+Project directory permission issue, ensure the directory owner is www:
+
+```shell
+chown -R www:www /opt/ace/projects/project-name
+```
+
+### Cannot Find node/npm
+
+Node.js installed via nvm is not in the default PATH.
+
+**Apps** -> **Supervisor Manager** -> **Manage** -> **Configuration**, add:
+
+```ini
+environment=PATH="/root/.nvm/versions/node/v24.0.0/bin:/usr/local/bin:/usr/bin:/bin"
+```
+
+Replace the version number with the actual installed version. You can check the path with `whereis node`.
+
+## Application Installation Failed
+
+1. Check network connection
+2. View error messages on the **Tasks** page
+3. Try clicking **Update Cache** on the **Apps** page and retry
+
+## Application Cannot Be Uninstalled
+
+Applications with dependencies need to uninstall dependent applications first.
+
+For example, phpMyAdmin depends on Nginx, so phpMyAdmin needs to be uninstalled first.
+
+## Multiple PHP Versions Coexistence
+
+Multiple PHP versions can be installed simultaneously. Select the corresponding version when creating a website.
+
+To switch versions for existing websites: **Edit** -> **Basic Settings** -> **PHP Version**.
diff --git a/zh_TW/faq/container.md b/zh_TW/faq/container.md
new file mode 100644
index 0000000..2d56661
--- /dev/null
+++ b/zh_TW/faq/container.md
@@ -0,0 +1,73 @@
+# Container FAQ
+
+## Image Pull Failed
+
+Servers in China cannot connect to Docker Hub and need to configure mirror acceleration.
+
+### Docker
+
+**Apps** -> **Docker** -> **Manage** -> **Configuration**, add:
+
+```json
+{
+ "registry-mirrors": [
+ "https://docker.1ms.run"
+ ]
+}
+```
+
+### Podman
+
+**Apps** -> **Podman** -> **Manage** -> **Registry Configuration**, add at the end:
+
+```toml
+[[registry]]
+location = "docker.io"
+[[registry.mirror]]
+location = "docker.1ms.run"
+```
+
+For mirror acceleration addresses, you can use [1ms Mirror](https://1ms.run/) or other services.
+
+## Compose Startup Failed
+
+1. Click **Logs** to view error messages
+2. Common causes:
+ - Port occupied: Modify the mapped port
+ - Image pull failed: Configure mirror acceleration
+ - Configuration error: Check docker-compose.yml syntax
+
+## Container Inaccessible
+
+1. Check if the container is running: View status in **Containers** -> **Containers** list
+2. Check if port mapping is correct
+3. Check if the firewall has allowed the mapped host port
+
+## Container Cannot Access External Network
+
+Check Docker network configuration:
+
+```shell
+docker network ls
+docker network inspect bridge
+```
+
+## Data Persistence
+
+Data will be lost after container deletion. Use volume mounts to persist data:
+
+Add volumes in the compose configuration:
+
+```yaml
+volumes:
+ - ./data:/app/data
+```
+
+## View Container Logs
+
+```shell
+docker logs container-name-or-id
+docker logs -f container-name-or-id # Real-time view
+```
+
+Or click **Logs** in the panel **Containers** -> **Containers** list.
diff --git a/zh_TW/faq/database.md b/zh_TW/faq/database.md
new file mode 100644
index 0000000..650a473
--- /dev/null
+++ b/zh_TW/faq/database.md
@@ -0,0 +1,73 @@
+# Database FAQ
+
+## Forgot Database Password
+
+### MySQL/MariaDB/Percona
+
+Modify user password in panel **Databases** -> **Users**.
+
+If you forgot the root password, you can view/reset it in **Apps** -> **MySQL/MariaDB/Percona** -> **Manage**.
+
+### PostgreSQL
+
+Modify user password in panel **Databases** -> **Users**.
+
+If you forgot the postgres user password, you can view/reset it in **Apps** -> **PostgreSQL** -> **Manage**.
+
+## Remote Database Connection
+
+Only local connections are allowed by default. For remote connections:
+
+MySQL/MariaDB/Percona:
+
+1. In **Databases** -> **Users**, create a new user with host set to `%` (allow all IPs) or a specific IP
+2. Allow database port 3306 in the firewall
+
+PostgreSQL:
+
+1. Go to **Apps** -> **PostgreSQL** -> **Manage**, edit the main configuration, find `listen_addresses`, uncomment it and change its value to `'*'`
+2. On the same page, edit the user configuration, add a line: `host all username (IP-address/mask/all) scram-sha-256` and save
+3. Restart the PostgreSQL service
+4. Allow database port 5432 in the firewall
+
+:::warning Security Warning
+It is not recommended to expose database ports to the public network. It is recommended to use SSH tunnels or VPN connections.
+:::
+
+## Connection Refused
+
+1. Check if the database service is running
+2. Check user permissions and host settings
+3. Check connection address: Use `localhost` or `127.0.0.1` for local connections
+
+## Large File Import Failed
+
+phpMyAdmin has upload limits. For large files, it is recommended to import via command line:
+
+```shell
+mysql -u username -p database_name < file.sql
+```
+
+Or upload using the panel's file manager, then execute the import in the terminal.
+
+## Database Backup
+
+1. **Backup** -> **Create Backup**, select database
+2. Or use command line:
+
+```shell
+# MySQL
+mysqldump -u username -p database_name > backup.sql
+
+# PostgreSQL
+pg_dump -U username database_name > backup.sql
+```
+
+## Character Set Issues
+
+To modify character set for existing databases:
+
+```sql
+ALTER
+DATABASE database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
+```
diff --git a/zh_TW/faq/panel.md b/zh_TW/faq/panel.md
new file mode 100644
index 0000000..83eb0cc
--- /dev/null
+++ b/zh_TW/faq/panel.md
@@ -0,0 +1,99 @@
+# Panel FAQ
+
+## Panel Won't Open
+
+SSH into the server and check panel status:
+
+```shell
+acepanel status
+```
+
+If the service has stopped, start it:
+
+```shell
+acepanel start
+```
+
+If it cannot start, try to repair:
+
+```shell
+acepanel fix && acepanel update
+```
+
+If the service is running but still inaccessible, check the firewall:
+
+```shell
+# Check if port is listening
+curl -I http://127.0.0.1:panel-port/
+
+# Allow port (firewalld)
+firewall-cmd --add-port=panel-port/tcp --permanent
+firewall-cmd --reload
+```
+
+For cloud servers, also check security group settings.
+
+View panel logs to troubleshoot:
+
+```shell
+journalctl -u acepanel -n 100
+```
+
+## Forgot Password/Username/Address
+
+```shell
+acepanel info
+```
+
+Outputs panel address, username, and generates a new password.
+
+## Change Panel Port
+
+```shell
+acepanel port 12345
+```
+
+After modification, you need to allow the new port in the server security group/firewall.
+
+## Disable Security Entry
+
+If you forgot the security entry path:
+
+```shell
+acepanel entrance off
+```
+
+## Disable Domain/IP Binding
+
+If you cannot access the panel after binding:
+
+```shell
+acepanel bind-domain off
+acepanel bind-ip off
+```
+
+## Disable Two-Factor Authentication
+
+```shell
+acepanel user 2fa admin
+```
+
+## Certificate Error
+
+The panel uses a self-signed certificate by default, and the browser will show an insecure warning. Click "Continue" to proceed.
+
+To apply for a proper certificate:
+
+```shell
+acepanel https generate
+```
+
+You need to ensure the server IP port 80 is directly accessible.
+
+## acepanel Command Permission Denied
+
+Must be executed as root user, or use sudo:
+
+```shell
+sudo acepanel status
+```
diff --git a/zh_TW/faq/project.md b/zh_TW/faq/project.md
new file mode 100644
index 0000000..2cc46d8
--- /dev/null
+++ b/zh_TW/faq/project.md
@@ -0,0 +1,68 @@
+# Project FAQ
+
+## Project Startup Failed
+
+Click **Logs** to view error messages. Common causes:
+
+### Permission Issues
+
+Project directory should be under `/opt/ace/projects/`, owned by www:
+
+```shell
+chown -R www:www /opt/ace/projects/project-name
+```
+
+If deployed under `/root`, you need to run as root user (not recommended).
+
+### Command Not Found
+
+Such as `node: No such file or directory`, indicates environment variables are not configured.
+
+Solutions:
+
+1. Associate runtime environment in **Edit** -> **Dependencies**
+2. Or add PATH in **Runtime Settings** -> **Environment Variables**
+
+### Port Already in Use
+
+Modify the application listening port, or stop the process occupying the port:
+
+```shell
+lsof -i:3000 # View process occupying the port
+```
+
+## Configure Environment Variables
+
+**Edit** -> **Runtime Settings** -> **Environment Variables**, click **Add**.
+
+Common configurations:
+
+- `NODE_ENV=production`
+- `PORT=3000`
+
+## Pre-start Command
+
+Executed before project startup, such as installing dependencies:
+
+- Node.js: `npm install` or `yarn`
+- Python: `pip install -r requirements.txt`
+- Go: `go build`
+
+## View Project Logs
+
+1. Panel: Click **Logs** in the project list
+2. Command line: `journalctl -u ace-project-project-name -f`
+
+## Project Auto Restart
+
+Configure in **Runtime Settings**:
+
+- **Restart Policy**: Restart on failure / Always restart / Never restart
+- **Restart Interval**: Wait time between restarts
+- **Max Restart Count**: Prevent infinite restarts
+
+## Reverse Proxy Configuration
+
+Enable **Reverse Proxy** when creating a project, and a reverse proxy website will be automatically created.
+
+Manual configuration: Create a reverse proxy website with upstream address `http://127.0.0.1:project-port`.
diff --git a/zh_TW/faq/website.md b/zh_TW/faq/website.md
new file mode 100644
index 0000000..6acfcbf
--- /dev/null
+++ b/zh_TW/faq/website.md
@@ -0,0 +1,80 @@
+# Website FAQ
+
+## Website Inaccessible
+
+1. Check if the domain is resolved to the server IP
+2. Check if the firewall has allowed ports 80/443
+3. Check if Nginx is running: **Apps** -> **Nginx** -> **Manage**
+4. View Nginx error logs
+
+## 403 Forbidden
+
+Usually a permission issue:
+
+```shell
+# Fix website directory permissions
+chown -R www:www /opt/ace/sites/website-name/public
+chmod -R 755 /opt/ace/sites/website-name/public
+```
+
+## 502 Bad Gateway
+
+For PHP websites with 502, check if PHP is running:
+
+1. **Apps** -> **Runtimes** -> **PHP** -> **Manage**
+2. Confirm PHP version matches website configuration
+3. View PHP error logs
+
+For reverse proxy websites with 502, check if the backend service is running.
+
+## Rewrite Rules Not Working
+
+1. Confirm the correct preset is selected or rules are filled in the **Rewrite** tab
+2. Nginx will automatically reload after clicking **Save**
+3. Clear browser cache and test
+
+## Configure QUIC (HTTP/3)
+
+The panel supports QUIC, but does not add the `Alt-Svc` header by default. Add in custom configuration:
+
+```nginx
+add_header Alt-Svc 'h3=":$server_port"; ma=2592000';
+```
+
+Ensure the server security group/firewall allows UDP port 443.
+
+## Enable TLSv1/TLSv1.1
+
+OpenSSL 3.x disables old protocols by default. If you must use them, modify the cipher suite in **HTTPS** settings:
+
+```nginx
+ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384:AES128-SHA:AES256-SHA:DES-CBC3-SHA:@SECLEVEL=0;
+```
+
+## Enable IPv6
+
+Add listening addresses in **Domains and Listening**: `[::]:80` and `[::]:443`.
+
+## CDN Origin and HTTPS
+
+| CDN Origin Protocol | Website HTTPS Configuration |
+| ------------------- | ------------------------------------------------------ |
+| HTTP | Not required |
+| HTTPS | Must be enabled |
+| Follow Protocol | Must be enabled, and HTTP redirect must not be enabled |
+
+## Upload File Size Limit
+
+Default limit is 100MB. Modify PHP configuration:
+
+1. **Apps** -> **Runtimes** -> **PHP** -> **Manage** -> **Main Configuration**
+2. Modify `upload_max_filesize` and `post_max_size`
+3. Restart PHP after saving
+
+## SSL Certificate Application Failed
+
+1. Confirm the domain is resolved to the server
+2. Confirm port 80 is accessible (required for Let's Encrypt verification)
+3. Check if Let's Encrypt rate limit is exceeded
+4. Try using DNS verification method
+5. Switch to another certificate provider
diff --git a/zh_TW/index.md b/zh_TW/index.md
new file mode 100644
index 0000000..fd6f5a6
--- /dev/null
+++ b/zh_TW/index.md
@@ -0,0 +1,65 @@
+---
+layout: home
+hero:
+ name: "AcePanel"
+ text: "簡單輕量 • 高效能運維"
+ tagline: 企業伺服器運維管理面板
+ actions:
+ - theme: brand
+ text: 🌟 點亮 Star
+ link: https://github.com/acepanel/panel
+ target: _blank
+ - theme: alt
+ text: 快速安裝
+ link: /zh_TW/quickstart/install
+features:
+ - icon: ✨
+ title: 極低佔用
+ details: 以 Go 語言開發，安裝包小，佔用低，單文件運行，不會影響系統性能
+ - icon: 🛠
+ title: 低破壞性
+ details: 設計為盡可能減少對系統的額外修改，在同類產品中，我們對系統的修改最少
+ - icon: 📅
+ title: 跟隨時代
+ details: 整體設計走在時代前沿，對新系統兼容性好，在同類產品中處於領先地位
+ - icon: 🚀
+ title: 高效運維
+ details: 功能完善，自定義能力強，既可快速部署小型網站，也可基於定制化需求部署複雜應用
+ - icon: ⛓️💥
+ title: 離線運行
+ details: 支持離線模式，甚至可以在部署完成後停止面板進程，不會對已有服務造成任何影響
+ - icon: 🛡
+ title: 安全穩定
+ details: 面板採用業界多種技術保障本體安全性，已在多個生產環境中長期穩定運行
+ - icon: 💽
+ title: 全面開源
+ details: 少有的全開源面板，您可以在遵守開源協議的前提下對面板自由修改、二次開發
+ - icon: 🆓
+ title: 永久免費
+ details: 承諾面板本體未來不會引入任何收費/授權功能，永久免費使用
+---
+
+## 合作夥伴
+
+
diff --git a/zh_TW/quickstart/cli.md b/zh_TW/quickstart/cli.md
new file mode 100644
index 0000000..f9833d1
--- /dev/null
+++ b/zh_TW/quickstart/cli.md
@@ -0,0 +1,57 @@
+# Command Line Tool
+
+AcePanel provides the command line tool `acepanel` for panel management when the Web interface is inaccessible.
+
+## Service Management
+
+:::warning Note
+Do not stop or restart the panel while background tasks are running, as this may cause task interruption or data loss.
+:::
+
+```shell
+acepanel start # Start
+acepanel stop # Stop
+acepanel restart # Restart
+acepanel status # View status
+```
+
+## User Management
+
+```shell
+acepanel user list # List all users
+acepanel user username Need Help?
+If you have any questions, feel free to join our QQ group for consultation
Join QQ Group 12370907 +