refactor: 为翻译做准备

en/about.md

@@ -0,0 +1,127 @@
+---
+sidebar: false
+prev: false
+next: false
+---
+
+<script setup>
+import { VPTeamMembers } from 'vitepress/theme'
+
+const members = [
+  {
+    avatar: 'https://weavatar.com/avatar/18e77debb1bc0000c0b50757b8f1bebb2c3e4df3d494124f776c15dbc1ebe8a5',
+    name: '耗子',
+    desc: '创始人 & CEO',
+    links: [
+      { icon: 'github', link: 'https://github.com/devhaozi' },
+      { icon: 'bilibili', link: 'https://space.bilibili.com/8067' }
+    ]
+  },
+  {
+    avatar: 'https://weavatar.com/avatar/f6b23deadaa481f0b3ea75ad94f246881ed2326117efebad6f2799ea165779b9',
+    name: '靓仔',
+    desc: '技术负责人',
+    links: [
+      { icon: 'github', link: 'https://github.com/205125' }
+    ]
+  },
+]
+</script>
+
+# 关于
+
+## 关于耗子面板
+
+耗子面板是一款专业的服务器运维管理面板，致力于为用户提供简单、高效、安全的服务器管理解决方案。
+
+| 愿景                | 使命            | 价值观            |
+|-------------------|---------------|----------------|
+| 成为领先的服务器管理解决方案提供商 | 让服务器管理变得简单而高效 | 用户至上、创新驱动、专业专注 |
+
+## 团队介绍
+
+<VPTeamMembers size="small" :members="members" />
+
+## 发展历程
+
+<style>
+  .about-timeline {
+    max-width: 800px;
+    margin: 0 auto 60px;
+    position: relative;
+  }
+  .about-timeline::before {
+    content: '';
+    position: absolute;
+    width: 2px;
+    background: #e7f1ff;
+    top: 0;
+    bottom: 0;
+    left: 50%;
+  }
+  .about-timeline-item {
+    margin-bottom: 30px;
+    position: relative;
+  }
+  .about-timeline-content {
+    padding: 20px;
+    border-radius: 8px;
+    width: 45%;
+    position: relative;
+  }
+  .about-timeline-dot {
+    width: 12px;
+    height: 12px;
+    background: #4a90e2;
+    border-radius: 50%;
+    position: absolute;
+    left: 50%;
+    transform: translateX(-50%);
+  }
+  .about-year {
+    color: #4a90e2;
+    font-weight: bold;
+    margin-bottom: 10px;
+  }
+  .about-h3 {
+    margin: 0!important;
+  }
+</style>
+
+<div class="about-timeline">
+  <div class="about-timeline-item">
+    <div class="about-timeline-content" style="margin-left: auto;">
+      <div class="about-year">2024</div>
+      <h3 class="about-h3">全新起航</h3>
+      <p>面板得到了众多赞助商的支持，2024 年下半年发布了全新的 2.3 版本</p>
+    </div>
+    <div class="about-timeline-dot"></div>
+  </div>
+
+  <div class="about-timeline-item">
+    <div class="about-timeline-content">
+      <div class="about-year">2023</div>
+      <h3 class="about-h3">技术积累</h3>
+      <p>使用 Go 对面板进行重写，发布 2.0 2.1 系列版本，积累了大量开发经验</p>
+    </div>
+    <div class="about-timeline-dot"></div>
+  </div>
+
+  <div class="about-timeline-item">
+    <div class="about-timeline-content" style="margin-left: auto;">
+      <div class="about-year">2022</div>
+      <h3 class="about-h3">项目立项</h3>
+      <p>2022 年中项目立项，年末发布 1.0 版本</p>
+    </div>
+    <div class="about-timeline-dot"></div>
+  </div>
+</div>
+
+## 联系我们
+
+| 名称   | 联系方式                                                                     |
+|------|--------------------------------------------------------------------------|
+| 企业微信 | [点击联系](https://work.weixin.qq.com/kfid/kfc20ea8e38b5a4e73a)              |
+| QQ   | [826896000](https://wpa.qq.com/msgrd?v=3&uin=826896000&site=qq&menu=yes) |
+| 电子邮件 | [admin@haozi.net](mailto:admin@haozi.net)                                |
+| 公司地址 | 天津市武清区黄庄街道泉里路1号智库大厦206室                                                  |

en/advanced/api.md

@@ -0,0 +1,661 @@
+# API 参考文档
+
+## 概述
+
+耗子面板提供了一套安全的 RESTful 接口，用于与面板系统进行交互。所有 API 请求都需要进行 HMAC-SHA256 签名认证以确保通信的安全性和完整性。
+
+## 基础信息
+
+- **基础 URL**: `http(s)://your-panel-domain/{entry}/api/`
+- **内容类型**: 所有请求和响应均使用 `application/json`
+- **字符编码**: UTF-8
+
+## 认证机制
+
+API 使用 HMAC-SHA256 签名算法进行认证。每个请求必须包含以下 HTTP 头：
+
+| 头部名称            | 描述                                                              |
+|-----------------|-----------------------------------------------------------------|
+| `Content-Type`  | 设置为 `application/json`                                          |
+| `X-Timestamp`   | 当前 UNIX 时间戳（秒）                                                  |
+| `Authorization` | 身份验证信息，格式为 `HMAC-SHA256 Credential={id}, Signature={signature}` |
+
+## 签名算法
+
+签名过程包含四个主要步骤：
+
+### 1. 构造规范化请求
+
+规范化请求字符串由以下部分组成，各部分之间使用换行符（\n）分隔：
+
+```
+HTTP方法
+规范化路径
+规范化查询字符串
+请求体的SHA256哈希值
+```
+
+**注意**：规范化路径应始终使用 `/api/` 开头的路径部分，忽略入口前缀。
+
+### 2. 构造待签名字符串
+
+待签名字符串包含以下部分，各部分使用换行符（\n）分隔：
+
+```
+"HMAC-SHA256"
+时间戳
+规范化请求的SHA256哈希值
+```
+
+### 3. 计算签名
+
+使用您的令牌（token）对待签名字符串进行 HMAC-SHA256 计算，然后将结果转换为十六进制字符串。
+
+### 4. 构造授权头
+
+将计算得到的签名添加到 `Authorization` 头：
+
+```
+Authorization: HMAC-SHA256 Credential={id}, Signature={signature}
+```
+
+## Go 示例
+
+```go
+package main
+
+import (
+    "bytes"
+    "crypto/hmac"
+    "crypto/sha256"
+    "encoding/hex"
+    "fmt"
+    "io"
+    "net/http"
+    "strings"
+    "time"
+)
+
+func main() {
+    // 创建一个获取用户信息的请求
+    req, err := http.NewRequest("GET", "http://example.com/entrance/api/user/info", nil)
+    if err != nil {
+        fmt.Println("Error creating request:", err)
+        return
+    }
+
+    // 设置内容类型
+    req.Header.Set("Content-Type", "application/json")
+    
+    // 签名请求 - 传入您的用户ID和API令牌
+    if err = SignReq(req, uint(16), "YourSecretToken"); err != nil {
+        fmt.Println("Error signing request:", err)
+        return
+    }
+
+    // 发送请求
+    client := &http.Client{}
+    resp, err := client.Do(req)
+    if err != nil {
+        fmt.Println("Error sending request:", err)
+        return
+    }
+    defer resp.Body.Close()
+
+    // 处理响应
+    body, err := io.ReadAll(resp.Body)
+    if err != nil {
+        fmt.Println("Error reading response:", err)
+        return
+    }
+
+    fmt.Println("Response Status:", resp.Status)
+    fmt.Println("Response Body:", string(body))
+}
+
+// SignReq 对HTTP请求进行签名
+func SignReq(req *http.Request, id uint, token string) error {
+    // 步骤一：构造规范化请求
+    var body []byte
+    var err error
+
+    if req.Body != nil {
+        // 读取并保存请求体
+        body, err = io.ReadAll(req.Body)
+        if err != nil {
+            return err
+        }
+        // 恢复请求体以便后续使用
+        req.Body = io.NopCloser(bytes.NewReader(body))
+    }
+
+    // 规范化路径
+    canonicalPath := req.URL.Path
+    if !strings.HasPrefix(canonicalPath, "/api") {
+        index := strings.Index(canonicalPath, "/api")
+        if index != -1 {
+            canonicalPath = canonicalPath[index:]
+        }
+    }
+
+    canonicalRequest := fmt.Sprintf("%s\n%s\n%s\n%s",
+        req.Method,
+        canonicalPath,
+        req.URL.Query().Encode(),
+        SHA256(string(body)))
+
+    // 步骤二：设置时间戳和构造待签名字符串
+    timestamp := time.Now().Unix()
+    req.Header.Set("X-Timestamp", fmt.Sprintf("%d", timestamp))
+
+    stringToSign := fmt.Sprintf("%s\n%d\n%s",
+        "HMAC-SHA256",
+        timestamp,
+        SHA256(canonicalRequest))
+
+    // 步骤三：计算签名
+    signature := HMACSHA256(stringToSign, token)
+
+    // 步骤四：设置Authorization头
+    authHeader := fmt.Sprintf("HMAC-SHA256 Credential=%d, Signature=%s", id, signature)
+    req.Header.Set("Authorization", authHeader)
+
+    return nil
+}
+
+func SHA256(str string) string {
+    sum := sha256.Sum256([]byte(str))
+    dst := make([]byte, hex.EncodedLen(len(sum)))
+    hex.Encode(dst, sum[:])
+    return string(dst)
+}
+
+func HMACSHA256(data string, secret string) string {
+    h := hmac.New(sha256.New, []byte(secret))
+    h.Write([]byte(data))
+    return hex.EncodeToString(h.Sum(nil))
+}
+```
+
+## PHP 示例
+
+```php
+<?php
+/**
+ * 耗子面板 API 请求示例 (PHP)
+ */
+
+function signRequest($method, $url, $body, $id, $token) {
+    // 解析URL并获取路径
+    $parsedUrl = parse_url($url);
+    $path = $parsedUrl['path'];
+    $query = isset($parsedUrl['query']) ? $parsedUrl['query'] : '';
+    
+    // 规范化路径
+    $canonicalPath = $path;
+    if (strpos($path, '/api') !== 0) {
+        $apiPos = strpos($path, '/api');
+        if ($apiPos !== false) {
+            $canonicalPath = substr($path, $apiPos);
+        }
+    }
+    
+    // 计算请求体的SHA256哈希值
+    $bodySha256 = hash('sha256', $body ?: '');
+    
+    // 构造规范化请求
+    $canonicalRequest = implode("\n", [
+        $method,
+        $canonicalPath,
+        $query,
+        $bodySha256
+    ]);
+    
+    // 获取当前时间戳
+    $timestamp = time();
+    
+    // 构造待签名字符串
+    $stringToSign = implode("\n", [
+        'HMAC-SHA256',
+        $timestamp,
+        hash('sha256', $canonicalRequest)
+    ]);
+    
+    // 计算签名
+    $signature = hash_hmac('sha256', $stringToSign, $token);
+    
+    // 返回签名和时间戳
+    return [
+        'timestamp' => $timestamp,
+        'signature' => $signature,
+        'id' => $id
+    ];
+}
+
+// 示例请求
+$apiUrl = 'http://example.com/entrance/api/user/info';
+$method = 'GET';
+$body = ''; // 对于GET请求，通常没有请求体
+$id = 16;
+$token = 'YourSecretToken';
+
+// 生成签名信息
+$signingData = signRequest($method, $apiUrl, $body, $id, $token);
+
+// 准备HTTP请求头
+$headers = [
+    'Content-Type: application/json',
+    'X-Timestamp: ' . $signingData['timestamp'],
+    'Authorization: HMAC-SHA256 Credential=' . $signingData['id'] . ', Signature=' . $signingData['signature']
+];
+
+// 使用cURL发送请求
+$ch = curl_init($apiUrl);
+curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
+curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
+
+if (!empty($body)) {
+    curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
+}
+
+// 执行请求并获取响应
+$response = curl_exec($ch);
+$statusCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
+curl_close($ch);
+
+// 输出结果
+echo "响应状态码: " . $statusCode . PHP_EOL;
+echo "响应内容: " . $response . PHP_EOL;
+```
+
+## Python 示例
+
+```python
+import hashlib
+import hmac
+import json
+import requests
+import time
+from urllib.parse import urlparse, parse_qs
+
+def sha256_hash(text):
+    """计算字符串的SHA256哈希值"""
+    return hashlib.sha256(text.encode('utf-8')).hexdigest()
+
+def hmac_sha256(key, message):
+    """使用HMAC-SHA256算法计算签名"""
+    return hmac.new(key.encode('utf-8'), message.encode('utf-8'), hashlib.sha256).hexdigest()
+
+def sign_request(method, url, body, user_id, token):
+    """为API请求生成签名"""
+    # 解析URL
+    parsed_url = urlparse(url)
+    path = parsed_url.path
+    query = parsed_url.query
+    
+    # 规范化路径
+    canonical_path = path
+    if not path.startswith('/api'):
+        api_pos = path.find('/api')
+        if api_pos != -1:
+            canonical_path = path[api_pos:]
+    
+    # 构造规范化请求
+    body_str = body if body else ""
+    canonical_request = "\n".join([
+        method,
+        canonical_path,
+        query,
+        sha256_hash(body_str)
+    ])
+    
+    # 获取当前时间戳
+    timestamp = int(time.time())
+    
+    # 构造待签名字符串
+    string_to_sign = "\n".join([
+        "HMAC-SHA256",
+        str(timestamp),
+        sha256_hash(canonical_request)
+    ])
+    
+    # 计算签名
+    signature = hmac_sha256(token, string_to_sign)
+    
+    return {
+        "timestamp": timestamp,
+        "signature": signature,
+        "id": user_id
+    }
+
+# 示例请求
+api_url = "http://example.com/entrance/api/user/info"
+method = "GET"
+body = ""  # GET请求通常没有请求体
+user_id = 16
+token = "YourSecretToken"
+
+# 生成签名信息
+signing_data = sign_request(method, api_url, body, user_id, token)
+
+# 准备HTTP请求头
+headers = {
+    "Content-Type": "application/json",
+    "X-Timestamp": str(signing_data["timestamp"]),
+    "Authorization": f"HMAC-SHA256 Credential={signing_data['id']}, Signature={signing_data['signature']}"
+}
+
+# 发送请求
+response = requests.request(
+    method=method,
+    url=api_url,
+    headers=headers,
+    data=body
+)
+
+# 输出结果
+print(f"响应状态码: {response.status_code}")
+print(f"响应内容: {response.text}")
+```
+
+## Java 示例
+
+```java
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.nio.charset.StandardCharsets;
+import java.security.MessageDigest;
+import java.time.Instant;
+import javax.crypto.Mac;
+import javax.crypto.spec.SecretKeySpec;
+import java.util.Base64;
+
+/**
+ * 耗子面板 API 请求示例 (Java)
+ */
+public class RatPanelApiExample {
+
+    public static void main(String[] args) {
+        try {
+            // 示例请求
+            String apiUrl = "http://example.com/entrance/api/user/info";
+            String method = "GET";
+            String body = ""; // 对于GET请求，通常没有请求体
+            int id = 16;
+            String token = "YourSecretToken";
+
+            // 生成签名信息
+            SigningData signingData = signRequest(method, apiUrl, body, id, token);
+
+            // 准备HTTP请求
+            HttpClient client = HttpClient.newHttpClient();
+            HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
+                    .uri(URI.create(apiUrl))
+                    .header("Content-Type", "application/json")
+                    .header("X-Timestamp", String.valueOf(signingData.timestamp))
+                    .header("Authorization", "HMAC-SHA256 Credential=" + signingData.id + 
+                            ", Signature=" + signingData.signature);
+
+            // 设置请求方法和请求体
+            if (method.equals("GET")) {
+                requestBuilder.GET();
+            } else {
+                requestBuilder.method(method, HttpRequest.BodyPublishers.ofString(body));
+            }
+
+            HttpRequest request = requestBuilder.build();
+
+            // 发送请求
+            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
+
+            // 输出结果
+            System.out.println("响应状态码: " + response.statusCode());
+            System.out.println("响应内容: " + response.body());
+
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+    }
+
+    static class SigningData {
+        long timestamp;
+        String signature;
+        int id;
+
+        SigningData(long timestamp, String signature, int id) {
+            this.timestamp = timestamp;
+            this.signature = signature;
+            this.id = id;
+        }
+    }
+
+    public static SigningData signRequest(String method, String url, String body, int id, String token) throws Exception {
+        // 解析URL
+        URI uri = new URI(url);
+        String path = uri.getPath();
+        String query = uri.getQuery() != null ? uri.getQuery() : "";
+        
+        // 规范化路径
+        String canonicalPath = path;
+        if (!path.startsWith("/api")) {
+            int apiPos = path.indexOf("/api");
+            if (apiPos != -1) {
+                canonicalPath = path.substring(apiPos);
+            }
+        }
+        
+        // 计算请求体的SHA256哈希值
+        String bodySha256 = sha256Hash(body != null ? body : "");
+        
+        // 构造规范化请求
+        String canonicalRequest = String.join("\n", 
+                method,
+                canonicalPath,
+                query,
+                bodySha256);
+        
+        // 获取当前时间戳
+        long timestamp = Instant.now().getEpochSecond();
+        
+        // 构造待签名字符串
+        String stringToSign = String.join("\n",
+                "HMAC-SHA256",
+                String.valueOf(timestamp),
+                sha256Hash(canonicalRequest));
+        
+        // 计算签名
+        String signature = hmacSha256(token, stringToSign);
+        
+        // 返回签名和时间戳
+        return new SigningData(timestamp, signature, id);
+    }
+    
+    private static String sha256Hash(String text) throws Exception {
+        MessageDigest digest = MessageDigest.getInstance("SHA-256");
+        byte[] hash = digest.digest(text.getBytes(StandardCharsets.UTF_8));
+        return bytesToHex(hash);
+    }
+    
+    private static String hmacSha256(String key, String message) throws Exception {
+        Mac mac = Mac.getInstance("HmacSHA256");
+        SecretKeySpec secretKeySpec = new SecretKeySpec(key.getBytes(StandardCharsets.UTF_8), "HmacSHA256");
+        mac.init(secretKeySpec);
+        byte[] hash = mac.doFinal(message.getBytes(StandardCharsets.UTF_8));
+        return bytesToHex(hash);
+    }
+    
+    private static String bytesToHex(byte[] bytes) {
+        StringBuilder hexString = new StringBuilder();
+        for (byte b : bytes) {
+            String hex = Integer.toHexString(0xff & b);
+            if (hex.length() == 1) {
+                hexString.append('0');
+            }
+            hexString.append(hex);
+        }
+        return hexString.toString();
+    }
+}
+```
+
+## Node.js 示例
+
+```javascript
+const crypto = require('crypto');
+const axios = require('axios');
+const url = require('url');
+
+/**
+ * 计算字符串的SHA256哈希值
+ * @param {string} text 待哈希的字符串
+ * @returns {string} 哈希结果（十六进制）
+ */
+function sha256Hash(text) {
+  return crypto.createHash('sha256').update(text || '').digest('hex');
+}
+
+/**
+ * 使用HMAC-SHA256算法计算签名
+ * @param {string} key 密钥
+ * @param {string} message 待签名的消息
+ * @returns {string} 签名结果（十六进制）
+ */
+function hmacSha256(key, message) {
+  return crypto.createHmac('sha256', key).update(message).digest('hex');
+}
+
+/**
+ * 为API请求生成签名
+ * @param {string} method HTTP方法
+ * @param {string} apiUrl API地址
+ * @param {string} body 请求体
+ * @param {number} id 用户ID
+ * @param {string} token 密钥
+ * @returns {object} 包含签名、时间戳和ID的对象
+ */
+function signRequest(method, apiUrl, body, id, token) {
+  // 解析URL
+  const parsedUrl = new url.URL(apiUrl);
+  const path = parsedUrl.pathname;
+  const query = parsedUrl.search.slice(1); // 移除开头的'?'
+  
+  // 规范化路径
+  let canonicalPath = path;
+  if (!path.startsWith('/api')) {
+    const apiPos = path.indexOf('/api');
+    if (apiPos !== -1) {
+      canonicalPath = path.slice(apiPos);
+    }
+  }
+  
+  // 构造规范化请求
+  const canonicalRequest = [
+    method,
+    canonicalPath,
+    query,
+    sha256Hash(body || '')
+  ].join('\n');
+  
+  // 获取当前时间戳
+  const timestamp = Math.floor(Date.now() / 1000);
+  
+  // 构造待签名字符串
+  const stringToSign = [
+    'HMAC-SHA256',
+    timestamp,
+    sha256Hash(canonicalRequest)
+  ].join('\n');
+  
+  // 计算签名
+  const signature = hmacSha256(token, stringToSign);
+  
+  return {
+    timestamp,
+    signature,
+    id
+  };
+}
+
+/**
+ * 发送API请求
+ */
+async function sendApiRequest() {
+  // 示例请求参数
+  const apiUrl = 'http://example.com/entrance/api/user/info';
+  const method = 'GET';
+  const body = ''; // GET请求通常没有请求体
+  const id = 16;
+  const token = 'YourSecretToken';
+  
+  try {
+    // 生成签名信息
+    const signingData = signRequest(method, apiUrl, body, id, token);
+    
+    // 准备HTTP请求头
+    const headers = {
+      'Content-Type': 'application/json',
+      'X-Timestamp': signingData.timestamp,
+      'Authorization': `HMAC-SHA256 Credential=${signingData.id}, Signature=${signingData.signature}`
+    };
+    
+    // 发送请求
+    const response = await axios({
+      method,
+      url: apiUrl,
+      headers,
+      data: body || undefined
+    });
+    
+    // 输出结果
+    console.log(`响应状态码: ${response.status}`);
+    console.log(`响应内容: ${JSON.stringify(response.data)}`);
+    
+  } catch (error) {
+    console.error('请求出错:', error.message);
+    if (error.response) {
+      console.error(`响应状态码: ${error.response.status}`);
+      console.error(`响应内容: ${JSON.stringify(error.response.data)}`);
+    }
+  }
+}
+
+// 执行请求
+sendApiRequest();
+```
+
+## 常见响应码
+
+| HTTP 状态码 | 描述      |
+|----------|---------|
+| 200      | 请求成功    |
+| 401      | 身份验证失败  |
+| 403      | 权限不足    |
+| 404      | 资源不存在   |
+| 422      | 请求参数错误  |
+| 500      | 服务器内部错误 |
+
+## 安全建议
+
+1. **保护您的 API 令牌**：不要在客户端代码中硬编码或公开您的 API 令牌
+2. **定期轮换令牌**：定期更改您的 API 令牌以提高安全性
+3. **配置 IP 白名单**：在生产环境中使用 IP 白名单限制访问
+
+## 常见问题解答
+
+### 签名验证失败
+
+如果遇到签名验证失败，请检查：
+
+- 确保使用了正确的 API 令牌和 ID
+- 检查客户端与服务器的时间是否准确，时间戳偏差大于 300 秒会导致验证失败
+- 确保请求体在计算签名前后没有被修改
+- 确保 URL 路径处理正确，注意规范化路径时需要移除入口前缀
+
+### 请求超时
+
+- 检查网络连接
+- 确认服务器状态
+- 考虑增加客户端的超时设置

en/advanced/hub-mirror.md

@@ -0,0 +1,32 @@
+# 配置容器镜像加速
+
+由于一些原因国内可能无法连接到 Docker Hub 拉取容器镜像，因此需要配置镜像加速。
+
+## 对于 Podman
+
+在面板打开 Podman 设置页面，导航到注册表配置选项卡。
+
+滚动到配置文件底部，添加如下配置并保存：
+
+```
+[[registry]]
+location = "docker.io"
+[[registry.mirror]]
+location = "docker.1ms.run"
+```
+
+其中 docker.1ms.run 为配置的镜像加速地址，可自行参考其他教程搭建使用。
+
+## 对于 Docker
+
+在面板打开 Docker 设置页面，导航到配置选项卡。
+
+添加如下配置并保存：
+
+```
+{
+  "registry-mirrors": ["https://docker.1ms.run"]
+}
+```
+
+其中 https://docker.1ms.run 为配置的镜像加速地址，可自行参考其他教程搭建使用。

en/advanced/proxy.md

@@ -0,0 +1,5 @@
+# 配置反向代理
+
+面板 v2.4.10+ 自带反向代理配置生成器，你可以通过站点伪静态配置页面的右上角打开使用。
+
+注意：如果设置反向代理后出现 CSS/JS 等静态资源无法正常加载的问题，请移除站点主配置文件中的**不记录静态文件日志**部分。

en/advanced/quic.md

@@ -0,0 +1,14 @@
+# 配置 QUIC（HTTP3）
+
+面板目前已支持自动 QUIC 配置，但是出于兼容性考虑，默认未添加 `Alt-Svc` 标头，浏览器在未检测到 `Alt-Svc` 标头时不会尝试使用 QUIC 连接。
+
+如果你不使用 CDN，可添加下述配置到网站伪静态中即可让浏览器知晓网站支持并使用 QUIC 连接。
+
+```
+add_header Alt-Svc 'h3=":$server_port"; ma=2592000';
+```
+
+如果你使用 CDN 或者前端还存在代理服务器，则 QUIC 需要在 CDN / 前端开启。
+如果配置后仍不生效，请检查浏览器版本和 UDP 443 端口的可用性。
+
+* 根据 Nginx 的 git 提交记录，1.25 版本下所有 QUIC 草案版本已经移除，因此 `Alt-Svc` 无需添加草案版本号。

en/advanced/safe.md

@@ -0,0 +1,32 @@
+# 安全性建议
+
+通过以下安全措施，几乎可以杜绝一切被黑/挂马问题。
+
+### 网站方面
+
+根据以往经验大多数被黑挂马都是程序漏洞造成的，与面板等环境无关，为了网站安全，你应该做到：
+
+1. 不要使用盗版程序、软件，特别是在你无法确定有没有被人加过料的情况下。
+2. 定期更新网站程序和软件环境，不要怕麻烦使用过时的软件程序，它们的安全性无法保证。
+3. 网站后台禁止使用弱密码，密码强烈建议使用随机生成器生成大于 20 位的混合密码并保存在安全位置，有条件建议开启程序的多因素身份验证（2FA）。
+4. 设置定时备份全站数据，不要裸奔。
+5. PHP 默认禁用了部分高危函数，非必要请勿删除。
+
+### 系统方面
+
+现代系统出现严重安全漏洞的概率是很低的，但是你仍应该做到：
+
+1. 定期更新系统软件。（使用 `yum update` 或 `apt upgrade`）。
+2. SSH 禁止使用弱密码和默认 22 端口，密码强烈建议使用随机生成器生成大于 20 位的混合密码并保存在安全位置，如果可以建议安装 Fail2ban 针对性保护。
+3. 不要随意给 777 权限和 www 用户的执行权限，可能造成极大安全隐患。
+4. 如果运营商提供 VNC 管理服务器，也可以考虑关闭 SSH，从源头上解决问题。
+
+### 面板方面
+
+面板拥有和 root 一样的权限，管理不当亦会造成严重安全问题，你应该做到：
+
+1. 定期更新面板及面板安装的应用。同时推荐关注我们的频道或者群，以第一时间接收各类更新消息。
+2. 面板禁止使用弱密码和默认 8888 端口，密码强烈建议使用随机生成器生成大于 20 位的混合密码并保存在安全位置。
+3. 建议修改添加面板入口和开启面板 HTTPS，防止被扫描器扫描和中间人攻击。
+4. 防火墙无必要请不要放行内部服务的端口（Redis 6379、MySQL 3306、PostgreSQL 5432等），可能造成严重安全隐患。（网站本地连接不需要放行，连不上是程序的问题）。
+5. 对安全性要求较高的情况下，可以考虑日常停止面板的运行，按需启动（面板停止运行不会影响网站、计划任务等的运行）。

en/advanced/supervisor.md

@@ -0,0 +1,5 @@
+# 配置进程守护
+
+1. 安装 Supervisor 管理器并打开。
+2. Supervisor 管理器中创建需要守护的进程（运行用户不建议使用 root）。
+3. 常见问题：[https://tom.moe/t/supervisor/3112](https://tom.moe/t/supervisor/3112)

en/advanced/tls.md

@@ -0,0 +1,11 @@
+# 配置 TLSv1.1 TLSv1
+
+当前面板OpenResty使用OpenSSL 3.0版本编译，默认禁用已弃用的TLSv1.1 TLSv1协议。
+
+当然，如果你的业务必须要使用这两个协议的话，可以使用下述SSL配置启用。
+
+```
+ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;
+ssl_ciphers 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:DHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-RSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES256-SHA256:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:DES-CBC3-SHA:@SECLEVEL=0;
+ssl_prefer_server_ciphers on;
+```

en/cert.md

@@ -0,0 +1,205 @@
+---
+sidebar: false
+prev: false
+next: false
+---
+
+# 证书
+
+若 3 个月免费证书无法满足您的需求，您可以选择购买更高级别的证书。我们提供 DV 单域名证书和 DV 通配符证书可供选择。
+
+受限价政策，具体价格及购买请直接通过右上角加群联系销售。
+
+<style>
+  .cert-cards-container {
+    display: flex;
+    gap: 20px;
+    margin-bottom: 40px;
+  }
+  
+  .cert-card {
+    flex: 1;
+    padding: 24px;
+    border-radius: 8px;
+    box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  }
+  
+  .cert-card-header {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 16px;
+  }
+  
+  .cert-card-title {
+    margin: 0!important;
+    border-top: unset!important;
+    padding-top: unset!important;
+  }
+  
+  .cert-subtitle {
+    margin-bottom: 8px;
+  }
+  
+  .cert-price {
+    font-size: 24px;
+    font-weight: bold;
+    margin-bottom: 24px;
+  }
+  
+  .cert-price span {
+    font-size: 14px;
+  }
+  
+  .cert-features {
+    margin-bottom: 24px;
+  }
+  
+  .cert-feature-item {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    margin-bottom: 12px;
+  }
+  
+  .cert-buy-button {
+    color: white;
+    width: 100%;
+    padding: 12px;
+    background: #4080ff;
+    border: none;
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: 16px;
+  }
+  
+  .cert-buy-button:hover {
+    background: #3570e0;
+  }
+  
+  .cert-features-section {
+    margin-top: 40px;
+  }
+  
+  .cert-features-grid {
+    display: grid;
+    grid-template-columns: repeat(2, 1fr);
+    gap: 24px;
+  }
+  
+  .cert-feature-card {
+    display: flex;
+    gap: 16px;
+    align-items: flex-start;
+  }
+  
+  .cert-feature-icon {
+    width: 40px;
+    height: 40px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    font-size: 24px;
+  }
+  
+  .cert-feature-content h3 {
+    margin: 8px 0!important;
+    font-size: 18px;
+  }
+  
+  .cert-feature-content p {
+    line-height: 1.5;
+  }
+</style>
+
+## 选购证书
+
+<div class="cert-cards-container">
+  <div class="cert-card">
+    <div class="cert-card-header">
+      <h2 class="cert-card-title">DV 单域名证书</h2>
+    </div>
+    <div class="cert-subtitle">国际知名品牌证书</div>
+    <div class="cert-price">¥1X<span>/年</span></div>
+    <div class="cert-features">
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>域名型证书（DV）</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>支持一个域名</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>一年有效期</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>快速颁发</span>
+      </div>
+    </div>
+    <button class="cert-buy-button">右上角联系销售购买</button>
+  </div>
+  <div class="cert-card">
+    <div class="cert-card-header">
+      <h2 class="cert-card-title">DV 通配符证书</h2>
+    </div>
+    <div class="cert-subtitle">国际知名品牌证书</div>
+    <div class="cert-price">¥1XX<span>/年</span></div>
+    <div class="cert-features">
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>域名型证书（DV）</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>通配所有子域</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>一年有效期</span>
+      </div>
+      <div class="cert-feature-item">
+        <span class="cert-check-icon">✓</span>
+        <span>快速颁发</span>
+      </div>
+    </div>
+    <button class="cert-buy-button">右上角联系销售购买</button>
+  </div>
+</div>
+
+## 证书特点
+
+<div class="cert-features-section">
+  <div class="cert-features-grid">
+    <div class="cert-feature-card">
+      <div class="cert-feature-icon">🛡️</div>
+      <div class="cert-feature-content">
+        <h3>安全可靠</h3>
+        <p>采用国际标准，保护网站安全</p>
+      </div>
+    </div>
+    <div class="cert-feature-card">
+      <div class="cert-feature-icon">⚡</div>
+      <div class="cert-feature-content">
+        <h3>快速签发</h3>
+        <p>简化签发流程，快速颁发证书</p>
+      </div>
+    </div>
+    <div class="cert-feature-card">
+      <div class="cert-feature-icon">💳</div>
+      <div class="cert-feature-content">
+        <h3>灵活付费</h3>
+        <p>多种规格可选，满足不同需求</p>
+      </div>
+    </div>
+    <div class="cert-feature-card">
+      <div class="cert-feature-icon">👨‍💻</div>
+      <div class="cert-feature-content">
+        <h3>专业服务</h3>
+        <p>专业技术支持，保障使用无忧</p>
+      </div>
+    </div>
+  </div>
+</div>

en/index.md

@@ -49,18 +49,18 @@ features:
 
 <div style="display: flex; justify-content: space-around; align-items: center; flex-wrap: wrap;">
     <a href="https://www.weixiaoduo.com/" style="padding: 1rem;">
-      <img width="160" src="/.github/assets/wxd.png" alt="微晓朵">
+      <img width="160" src="/wxd.png" alt="微晓朵">
     </a>
     <a href="https://www.dkdun.cn/aff/MQZZNVHQ" style="padding: 1rem;">
-      <img width="160" src="/.github/assets/dk.png" alt="林枫云">
+      <img width="160" src="/dk.png" alt="林枫云">
     </a>
     <a href="https://waf.pro/">
-      <img width="160" src="/.github/assets/wafpro.png" alt="WAFPRO" style="padding: 1rem;">
+      <img width="160" src="/wafpro.png" alt="WAFPRO" style="padding: 1rem;">
     </a>
     <a href="https://scdn.ddunyun.com/">
-      <img width="160" src="/.github/assets/ddunyun.png" alt="盾云SCDN" style="padding: 1rem;">
+      <img width="160" src="/ddunyun.png" alt="盾云SCDN" style="padding: 1rem;">
     </a>
     <a href="https://1ms.run/" style="padding: 1rem;">
-      <img width="160" src="/.github/assets/1ms.svg" alt="毫秒镜像">
+      <img width="160" src="/1ms.svg" alt="毫秒镜像">
     </a>
 </div>

en/quickstart/container.md

@@ -0,0 +1,24 @@
+# 管理容器
+
+开始前需安装 Docker / Podman 容器引擎。
+
+容器引擎安装完毕后，即可前往面板容器管理处创建容器（此处以 pgadmin4 为例）。
+
+首先导航到镜像选项卡拉取需要的镜像，视网络环境可能需要数分钟到数十分钟。
+
+![拉取镜像](container1.png)
+
+镜像拉取完成后，导航到容器选项卡开始创建容器。
+
+![创建容器](container2.png)
+
+表单内容按容器的说明填写，此处使用的 pgadmin4 镜像需要映射 80 端口及配置 2 个默认环境变量，无需映射目录。
+
+容器创建完成后可点击右上角刷新按钮和容器右侧的日志按钮检查是否正常启动。
+
+![容器启动](container3.png)
+
+若容器未能启动，请根据日志进行修正。
+如果映射了外部端口，需要到防火墙菜单放行相应的端口。
+
+![创建成功](container4.png)

en/quickstart/disk.md

@@ -0,0 +1,9 @@
+# 挂载分区
+
+如果您的服务器有未挂载的数据盘，可在安装前以 `root` 用户登录服务器运行以下命令自动挂载，面板安装后不支持跨目录迁移。
+
+```shell
+curl -fsLm 10 -o auto_mount.sh https://dl.cdn.haozi.net/panel/auto_mount.sh && bash auto_mount.sh
+```
+
+也可工单联系服务器提供商要求协助挂载分区，或者自行挂载分区后再安装面板。

en/quickstart/install.md

@@ -0,0 +1,40 @@
+# 安装面板
+
+面板支持 `amd64` | `arm64` 架构下的主流系统，下表中的系统均已测试 LNMP 环境安装。
+
+优先建议使用标注**推荐**的系统，无特殊情况不建议使用标注**不推荐**的系统。
+
+不在下表中的其他系统，可自行尝试安装，但不提供无偿技术支持。
+
+| 系统                  | 版本  | 备注  |
+|---------------------|-----|-----|
+| AlmaLinux           | 9   | 推荐  |
+| AlmaLinux           | 8   | 不推荐 |
+| RockyLinux          | 9   | 支持  |
+| RockyLinux          | 8   | 不推荐 |
+| CentOS Stream       | 9   | 不推荐 |
+| CentOS Stream       | 8   | 不推荐 |
+| Ubuntu              | 24  | 推荐  |
+| Ubuntu              | 22  | 支持  |
+| Debian              | 12  | 推荐  |
+| Debian              | 11  | 支持  |
+| OpenCloudOS         | 9   | 支持  |
+| TencentOS Server    | 4   | 支持  |
+| TencentOS Server    | 3.1 | 不推荐 |
+| Alibaba Cloud Linux | 3.2 | 不推荐 |
+| Anolis              | 8   | 不推荐 |
+| openEuler           | 22  | 不推荐 |
+
+随着系统版本的不断更新，我们亦可能会终止部分过于老旧的系统的支持，以保证面板的健壮性。
+
+## 开始安装
+
+> 如需挂载分区，请在安装面板前完成，面板安装后不支持跨目录迁移。
+
+以 `root` 用户登录服务器，运行以下命令安装面板：
+
+```shell
+curl -fsLm 10 -o install.sh https://dl.cdn.haozi.net/panel/install.sh && bash install.sh
+```
+
+一般 2 分钟内即可完成安装，安装过程中请勿关闭终端。

en/quickstart/panel.md

@@ -0,0 +1,27 @@
+# 管理面板
+
+请勿在面板仍有任务运行时操作停止 / 重启面板，否则可能会造成问题。
+
+* 启动面板：`systemctl start panel`
+* 停止面板：`systemctl stop panel`
+* 重启面板：`systemctl restart panel`
+
+## 面板命令行
+
+```bash
+panel-cli
+```
+
+可根据提示补全需要的命令进行操作。
+
+## 卸载面板
+
+优先建议备份数据重装系统，这样可以保证系统纯净。
+
+如果您无法重装系统，请以`root`用户登录服务器，执行以下命令卸载面板：
+
+```shell
+curl -fsLm 10 -o uninstall.sh https://dl.cdn.haozi.net/panel/uninstall.sh && bash uninstall.sh
+```
+
+卸载面板前请务必备份好所有数据，提前卸载面板全部应用。卸载后数据将**无法恢复**！

en/support.md

@@ -0,0 +1,37 @@
+---
+sidebar: false
+prev: false
+next: false
+---
+
+# 支持
+
+## 免费论坛服务
+
+我们提供免费的论坛服务，您可以在论坛中提问、交流、分享面板使用中的问题。
+
+- [Moe Tom](https://tom.moe)
+
+## 付费远程服务
+
+网站报错、速度慢、被挂马？服务器资源占用高、配置调优、入侵朔源？我们统统一站式服务。
+
+### 远程服务价格表
+
+远程服务是指我们通过远程协助的方式，帮助您解决问题。
+
+| 名称   | 介绍               | 价格    |
+|------|------------------|-------|
+| 单次服务 | 仅限一次服务，问题解决服务即结束 | ￥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)

en/version-[version].md

@@ -0,0 +1,8 @@
+# v{{ $params.version }}
+
+- 版本类型：{{ $params.type == 'stable' ? '稳定版' : '测试版' }}
+- 发布时间：{{ $params.time }}
+
+## 更新内容
+
+<!-- @content -->

en/version-[version].paths.ts

@@ -0,0 +1,17 @@
+export default {
+    async paths() {
+        const resp = await (await fetch('https://panel.haozi.net/api/versions')).json()
+        if (!resp.message || resp.message !== 'success') return []
+
+        return resp.data.slice(0, 10).map((item: any) => {
+            return {
+                params: {
+                    version: item.version,
+                    type: item.type,
+                    time: item.updated_at.replace('T', ' ').slice(0, 19)
+                },
+                content: item.description
+            }
+        })
+    }
+}