更新文档

Author: Andyguo5891

docs/index.md

@@ -24,4 +24,6 @@
 
 ## 3 致谢贡献者
 
-[点击获取你的贡献者证书，参与社区回馈活动。](https://www.lxware.cn/1panel-contributors#/)
+!!! note ""
+
+    [点击获取你的贡献者证书，参与社区回馈活动。](https://www.lxware.cn/1panel-contributors#/)

docs/installation/cli.md

@@ -23,7 +23,9 @@
       restore                     恢复 1Panel 服务及数据
     ```
 
-## 2 1pctl reset
+## 2 1pctl 典型应用说明
+
+### 2.1 1pctl reset
 
 !!! note ""
     **重置 1Panel 系统信息，包括取消安全入口登录，取消两步验证等**
@@ -41,7 +43,7 @@
       mfa         取消 1Panel 两步验证
     ```
 
-## 3 1pctl listen-ip
+### 2.2 1pctl listen-ip
 
 !!! note ""
     **修改 1Panel 监听 IP**
@@ -56,7 +58,7 @@
       ipv6                监听 IPv6
     ```
 
-## 4 1pctl update
+### 2.3 1pctl update
 
 !!! note ""
     **修改 1Panel 系统信息**

docs/installation/master_migrate.md

@@ -1,52 +1,60 @@
-## 1. 安装 1panel-migrator
+## 1 安装 1panel-migrator
 
 ### 1.1 安装包获取
 
-请访问 Gitee 发布页，手动下载适用于您服务器架构的安装包，并将其放置到 `/tmp` 目录：
-
-> 🔗 https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/
-
-**提示**：请确保安装包版本 **大于等于 v2.0.8**，该版本及以上才支持主从节点切换功能。
+!!! note ""
 
-每个版本会提供以下架构的安装包（文件名示例）：
+     请访问 [1PanelGitee 发布页面](https://gitee.com/fit2cloud-feizhiyun/1panel-migrator/releases/)，手动下载适用于您服务器架构的安装包，并将其放置到 `/tmp` 目录：
 
-- `1panel-migrator-linux-amd64`
-- `1panel-migrator-linux-arm64`
-- `1panel-migrator-linux-arm`
-- `1panel-migrator-linux-ppc64le`
-- `1panel-migrator-linux-s390x`
+    **提示**：请确保安装包版本 **大于等于 v2.0.8**，该版本及以上才支持主从节点切换功能。
+    
+    每个版本会提供以下架构的安装包（文件名示例）：
+    
+    - `1panel-migrator-linux-amd64`
+    - `1panel-migrator-linux-arm64`
+    - `1panel-migrator-linux-arm`
+    - `1panel-migrator-linux-ppc64le`
+    - `1panel-migrator-linux-s390x`
 
-### 1.2 安装步骤（以 amd64 架构为例）
+### 1.2 安装步骤
 
-```bash
-# 1. 进入临时目录
-cd /tmp
+!!! note ""
 
-# 2. 添加执行权限
-chmod +x 1panel-migrator-linux-amd64
+    以 amd64 架构为例说明 1panel-migrator 的安装步骤：
 
-# 3. 移动至系统 PATH 中并重命名
-mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator
-```
+    ```bash
+    # （1）进入临时目录
+    cd /tmp
+    
+    # （2）添加执行权限
+    chmod +x 1panel-migrator-linux-amd64
+    
+    # （3）移动至系统 PATH 中并重命名
+    mv 1panel-migrator-linux-amd64 /usr/local/bin/1panel-migrator
+    ```
 
-## 2. 从节点 -> 主节点
+## 2 从节点 -> 主节点
 
 !!! note ""
 
     从节点升级为主节点需要先在原来主节点上设置好主节点备份，仅存在备份文件的主节点支持升级到主节点
 
-1. 打开节点列表，点击上方主节点备份
-2. 勾选备份节点，设置自动备份频率及保留份数，保存设置
-3. 点击执行备份，查看备份结果
+    （1）打开节点列表，点击上方主节点备份。
+
+    （2）勾选备份节点，设置自动备份频率及保留份数，保存设置。
+
+    （3）点击执行备份，查看备份结果。
 
     ![img.png](../../img/installation/master_backup.png)
 
-4. 打开需要升级的从节点，通过安装好的 1panel-migrator 执行升级命令 `1panel-migrator promote`
+    （4）打开需要升级的从节点，通过安装好的 1panel-migrator 执行升级命令 `1panel-migrator promote`
 
     ![img.png](../../img/installation/promote.png)
 
-## 3. 主节点 -> 从节点
+## 3 主节点 -> 从节点
+
+!!! note ""
 
-1. 打开需要降级的主节点，通过安装好的 1panel-migrator 执行降级命令 `1panel-migrator demote`
+    打开需要降级的主节点，通过安装好的 1panel-migrator 执行降级命令 `1panel-migrator demote`。
 
     ![img.png](../../img/installation/demote.png)

docs/installation/online_installation.md

@@ -20,8 +20,10 @@
 !!! note ""
     GitHub release 链接: https://github.com/1Panel-dev/1Panel/releases
 
-执行以下安装脚本，根据命令行提示完成安装。
+    
 !!! note ""
+
+    执行以下安装脚本，根据命令行提示完成安装。
     ```bash
     bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"
     ```
@@ -42,8 +44,8 @@
     http://目标服务器 IP 地址:目标端口/安全入口
     ```
 
-    - **如果使用的是云服务器，请至安全组开放目标端口。**
-    - **ssh 登录 1Panel 服务器后，执行 1pctl user-info 命令可获取安全入口（entrance）**
+    - **如果使用的是云服务器，请在安全组中开放对应的目标端口。**
+    - **ssh 登录 1Panel 服务器后，执行 `1pctl user-info` 命令可获取安全入口（entrance）。**
 
 !!! note ""
     安装成功后，可使用 [1pctl](cli.md) 命令行工具来维护 1Panel

docs/installation/v1_migrate.md

@@ -8,85 +8,105 @@
 !!! warning "注意"
     为确保迁移顺利、安全，请务必在执行前仔细阅读以下内容。
 
-### 建议提前创建快照
+### 1 创建快照
 
-为防止意外风险，强烈建议：
+!!! note ""
+    为防止意外风险，强烈建议：
 
-- 登录 **1Panel 控制台 → 面板设置** 页面，手动创建系统快照；
-- 或通过云服务商平台创建云主机快照。
+    - 登录 **1Panel 控制台 → 面板设置** 页面，手动创建系统快照；
+    - 或通过云服务商平台创建云主机快照。
 
-### V1 版本要求
+### 2 版本说明
 
-仅支持 **1Panel `v1.10.29-lts` 及以上版本** 执行迁移操作。
+!!! note ""
 
-### 迁移后的 V2 版本
+    - 仅支持 **1Panel `v1.10.29-lts` 及以上版本** 执行迁移操作。
+    - 执行迁移后，系统将升级至 **1Panel v2.0.0 版本**
 
-执行迁移后，系统将升级至 **1Panel v2.0.0 版本**
+### 3 专业版与许可证
 
-### 专业版与许可证
+!!! note ""
 
-- 原有许可证将被清除，统一迁移为 **社区版本**；
-- V1 的买断许可证无法在 V2 中使用，但可前往 [凌霞官网](https://www.lxware.cn/) 进行升级；
-- 许可证导入 V2 前，请先前往 [凌霞官网](https://www.lxware.cn/) 确认是否已成功解绑。
+    - 原有许可证将被清除，统一迁移为 **社区版本**；
+    - V1 的买断许可证无法在 V2 中使用，但可前往 [凌霞官网](https://www.lxware.cn/) 进行升级；
+    - 许可证导入 V2 前，请先前往 [凌霞官网](https://www.lxware.cn/) 确认是否已成功解绑。
 
-### 网站
+### 4 升级后数据更新说明
 
-#### 网站主目录迁移
+#### 4.1 网站
 
-迁移完成后，**所有网站配置将存放于 `{1Panel 安装目录}/www`**
+!!! note ""
 
-> 例如：`/opt/1panel/www`
+    - **网站主目录迁移**
 
-#### OpenResty 版本
+    迁移完成后，**所有网站配置将存放于 `{1Panel 安装目录}/www`**，例如：`/opt/1panel/www`
 
-系统将自动升级至 **OpenResty `1.27.1.2-0-1-focal`**
+    - **OpenResty 版本**
 
-#### OpenResty 主配置文件
+    系统将自动升级至 **OpenResty `1.27.1.2-0-1-focal`**
 
-由于 `1panel-migrator upgrade website` 会重置 OpenResty 主配置文件，如有自定义修改，请提前备份。
+     - **OpenResty 主配置文件**
 
-#### PHP 运行环境网站
+    由于 `1panel-migrator upgrade website` 会重置 OpenResty 主配置文件，如有自定义修改，请提前备份。
 
-- 面板内置的 PHP 环境将被移除；
-- **已创建网站中的 PHP 容器不会删除**，将被迁移至 静态网站；
-- 后续可创建 V2 版本的 PHP 运行环境，在原网站设置中将迁移的静态网站切换为 PHP 网站。
+    - **PHP 运行环境网站**
 
-#### 反向代理网站
+    （1）面板内置的 PHP 环境将被移除；
 
-由于 V2 重构了反代缓存机制，改为每个网站使用独立目录，因此在执行 `1panel-migrator upgrade website` 前，请确认所有网站的反代缓存已关闭。
+    （2）**已创建网站中的 PHP 容器不会删除**，将被迁移至 静态网站；
 
-### 备份记录
+    （3）后续可创建 V2 版本的 PHP 运行环境，在原网站设置中将迁移的静态网站切换为 PHP 网站。
 
-出于兼容性考虑：
+    - **反向代理网站**
 
-- 所有 **V1 的网站、应用和数据库备份记录将被清空**；
-- 请在迁移完成后重新配置备份策略。
+    由于 V2 重构了反代缓存机制，改为每个网站使用独立目录，因此在执行 `1panel-migrator upgrade website` 前，请确认所有网站的反代缓存已关闭。
 
-### 主机终端
+#### 4.2 备份记录
 
-主机列表、分组和快速命令仅在升级为主节点时迁移；若升级为从节点，这部分数据将不会迁移。
+!!! note ""
 
-### 计划任务
+    出于兼容性考虑：
+    
+    - 所有 **V1 的网站、应用和数据库备份记录将被清空**；
+    - 请在迁移完成后重新配置备份策略。
 
-- **计划任务本身会迁移**；
-- **任务的执行记录不会保留**。
+#### 4.3 主机终端
 
-### 快照
+!!! note ""
 
-由于版本机制差异，**V1 的快照记录无法迁移至 V2**。
+    主机列表、分组和快速命令仅在升级为主节点时迁移；若升级为从节点，这部分数据将不会迁移。
 
-### 面板设置
+#### 4.4 计划任务
 
-升级完成后，所有节点的面板设置将以当前 V2 主节点的配置为准。
+!!! note ""
 
-### WAF 和网站监控
+    - **计划任务本身会迁移**；
+    - **任务的执行记录不会保留**。
 
-由于架构升级：
+#### 4.5 快照
 
-- **V1 的 WAF 配置与网站监控记录大部分不兼容**，不会被迁移；
-- WAF 仅保留：黑白名单、IP组、自定义规则；
-- 迁移后请重新配置相关功能。
+!!! note ""
 
-### 问题反馈
+    由于版本机制差异，**V1 的快照记录无法迁移至 V2**。
 
-如果您在使用过程中遇到任何问题或有其他反馈，请在 [1Panel 主仓库](https://github.com/1Panel-dev/1Panel/issues) 提交 Issue。
+#### 4.6 面板设置
+
+!!! note ""
+
+    升级完成后，所有节点的面板设置将以当前 V2 主节点的配置为准。
+
+#### 4.7 WAF 和网站监控
+
+!!! note ""
+
+    由于架构升级：
+
+    - **V1 的 WAF 配置与网站监控记录大部分不兼容**，不会被迁移；
+    - WAF 仅保留：黑白名单、IP组、自定义规则；
+    - 迁移后请重新配置相关功能。
+
+#### 4.8 问题反馈
+
+!!! note ""
+
+    如果您在使用过程中遇到任何问题或有其他反馈，请在 [1Panel 主仓库](https://github.com/1Panel-dev/1Panel/issues) 提交 Issue。