From 5285d2f904e5fd54f2f95c08ae2b57b7fd099732 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=80=97=E5=AD=90?= Date: Mon, 26 May 2025 22:49:17 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E4=B8=AD=E6=96=87?= =?UTF-8?q?=E7=BF=BB=E8=AF=91?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .vitepress/config/en.ts | 11 +- .vitepress/config/index.ts | 8 +- .vitepress/config/shared.ts | 2 +- .vitepress/config/zh_CN.ts | 133 +++++++ en/about.md | 5 +- en/advanced/api.md | 9 +- en/advanced/hub-mirror.md | 9 +- en/advanced/proxy.md | 6 +- en/advanced/quic.md | 10 +- en/advanced/safe.md | 33 +- en/advanced/supervisor.md | 3 +- en/advanced/tls.md | 5 +- en/cert.md | 6 +- en/index.md | 6 +- en/quickstart/container.md | 13 +- en/quickstart/disk.md | 6 +- en/quickstart/install.md | 12 +- en/quickstart/panel.md | 6 +- en/support.md | 3 +- zh_CN/about.md | 64 +++ zh_CN/advanced/api.md | 661 +++++++++++++++++++++++++++++++ zh_CN/advanced/hub-mirror.md | 32 ++ zh_CN/advanced/proxy.md | 5 + zh_CN/advanced/quic.md | 15 + zh_CN/advanced/safe.md | 33 ++ zh_CN/advanced/supervisor.md | 5 + zh_CN/advanced/tls.md | 11 + zh_CN/cert.md | 212 ++++++++++ zh_CN/index.md | 62 +++ zh_CN/quickstart/container.md | 24 ++ zh_CN/quickstart/disk.md | 9 + zh_CN/quickstart/install.md | 40 ++ zh_CN/quickstart/panel.md | 27 ++ zh_CN/support.md | 37 ++ zh_CN/version-[version].md | 8 + zh_CN/version-[version].paths.ts | 17 + 36 files changed, 1450 insertions(+), 98 deletions(-) create mode 100644 .vitepress/config/zh_CN.ts create mode 100644 zh_CN/about.md create mode 100644 zh_CN/advanced/api.md create mode 100644 zh_CN/advanced/hub-mirror.md create mode 100644 zh_CN/advanced/proxy.md create mode 100644 zh_CN/advanced/quic.md create mode 100644 zh_CN/advanced/safe.md create mode 100644 zh_CN/advanced/supervisor.md create mode 100644 zh_CN/advanced/tls.md create mode 100644 zh_CN/cert.md create mode 100644 zh_CN/index.md create mode 100644 zh_CN/quickstart/container.md create mode 100644 zh_CN/quickstart/disk.md create mode 100644 zh_CN/quickstart/install.md create mode 100644 zh_CN/quickstart/panel.md create mode 100644 zh_CN/support.md create mode 100644 zh_CN/version-[version].md create mode 100644 zh_CN/version-[version].paths.ts diff --git a/.vitepress/config/en.ts b/.vitepress/config/en.ts index 3592292..84b8d0e 100644 --- a/.vitepress/config/en.ts +++ b/.vitepress/config/en.ts @@ -1,4 +1,4 @@ -import {defineConfig, type DefaultTheme} from 'vitepress' +import {type DefaultTheme, defineConfig} from 'vitepress' const resp = await (await fetch('https://panel.haozi.net/api/versions')).json() const versions = resp.data.slice(0, 10).map((item: any) => { @@ -7,7 +7,8 @@ const versions = resp.data.slice(0, 10).map((item: any) => { export const config = defineConfig({ lang: 'en-US', - description: "Goravel is a web application framework with complete functions and excellent scalability. As a starting scaffolding to help Gopher quickly build their own applications.", + title: 'RatPanel', + description: "Simple · lightweight · efficient", themeConfig: { nav: nav(), @@ -15,12 +16,12 @@ export const config = defineConfig({ sidebar: [ { text: "Quickstart", - base: '/quickstart/', + base: '/quickstart', items: sidebarQuickstart() }, { text: "Advanced", - base: '/advanced/', + base: '/advanced', items: sidebarAdvanced() }, { @@ -42,7 +43,7 @@ export const config = defineConfig({ text: 'Edit this page on GitHub' }, footer: { - message: 'Released under the MIT License', + message: 'It is strictly forbidden to use Rat Panel for illegal activities, and our company does not provide any services to violators', copyright: `Copyright © 2022-${new Date().getFullYear()} Tianjin Rat Technology Co., Ltd All Rights Reserved` }, docFooter: { diff --git a/.vitepress/config/index.ts b/.vitepress/config/index.ts index 7dac8e5..54a0917 100644 --- a/.vitepress/config/index.ts +++ b/.vitepress/config/index.ts @@ -1,6 +1,7 @@ -import { defineConfig } from 'vitepress' -import { shared } from './shared' -import { config as en } from './en' +import {defineConfig} from 'vitepress' +import {shared} from './shared' +import {config as en} from './en' +import {config as zh_CN} from './zh_CN' // https://vitepress.dev/reference/site-config @@ -8,5 +9,6 @@ export default defineConfig({ ...shared, locales: { root: { label: 'English', ...en }, + zh_CN: {label: '简体中文', ...zh_CN}, }, }) \ No newline at end of file diff --git a/.vitepress/config/shared.ts b/.vitepress/config/shared.ts index 1d461b2..85f42c5 100644 --- a/.vitepress/config/shared.ts +++ b/.vitepress/config/shared.ts @@ -27,7 +27,7 @@ export const shared = defineConfig({ md.use(groupIconMdPlugin); md.use(timeline); }, - languages: ['go', 'bash', 'shell'] + languages: ['go', 'bash', 'shell', 'nginx', 'ini', 'docker', 'dockerfile', 'json', 'yml', 'yaml'] }, themeConfig: { diff --git a/.vitepress/config/zh_CN.ts b/.vitepress/config/zh_CN.ts new file mode 100644 index 0000000..e6b2dc8 --- /dev/null +++ b/.vitepress/config/zh_CN.ts @@ -0,0 +1,133 @@ +import {type DefaultTheme, defineConfig} from 'vitepress'; + +const resp = await (await fetch('https://panel.haozi.net/api/versions')).json() +const versions = resp.data.slice(0, 10).map((item: any) => { + return item.version +}) +export const config = defineConfig({ + lang: "zh-CN", + title: "耗子面板", + description: "简单轻量 • 高效运维", + themeConfig: { + nav: nav(), + + sidebar: [ + { + text: "快速开始", + base: '/zh_CN/quickstart', + items: sidebarQuickstart() + }, + { + text: "进阶指南", + base: '/zh_CN/advanced', + items: sidebarAdvanced() + }, + { + text: "版本历史", + base: '/zh_CN', + collapsed: true, + items: [ + ...versions.map((version: string) => { + return { + text: version, + link: `/version-${version}` + } + }) + ] + }, + ], + editLink: { + pattern: 'https://github.com/ratpanel/ratpanel.github.io/edit/main/:path', + text: "在 GitHub 上编辑此页面" + }, + footer: { + message: '严禁使用耗子面板从事违法活动，我司不对违规用户提供任何服务', + copyright: `© 2022-${new Date().getFullYear()} 天津耗子科技有限公司 版权所有丨津ICP备2022009678号-1丨津公网安备12011502000848号` + }, + docFooter: { + prev: "上一页", + next: "下一页" + }, + outline: { + label: "页面导航" + }, + lastUpdated: { + text: "最后更新于", + formatOptions: { + dateStyle: 'short', + timeStyle: 'medium' + } + }, + langMenuLabel: "切换语言", + returnToTopLabel: "回到顶部", + sidebarMenuLabel: "菜单", + darkModeSwitchLabel: "主题", + lightModeSwitchTitle: "切换到浅色主题", + darkModeSwitchTitle: "切换到深色主题", + skipToContentLabel: "跳转到内容" + } +}); + +function nav(): DefaultTheme.NavItem[] { + return [ + {text: '首页', link: '/zh_CN/'}, + {text: '文档', link: '/zh_CN/quickstart/install'}, + {text: '支持', link: '/zh_CN/support'}, + {text: '🔥证书', link: '/zh_CN/cert'}, + {text: '关于', link: '/zh_CN/about'}, + ] +} + +function sidebarQuickstart(): DefaultTheme.SidebarItem[] { + return [ + { + text: '安装面板', + link: '/install' + }, + { + text: '挂载分区', + link: '/disk' + }, + { + text: '管理面板', + link: '/panel' + }, + { + text: '管理容器', + link: '/container' + }, + ] +} + +function sidebarAdvanced(): DefaultTheme.SidebarItem[] { + return [ + { + text: '面板 API', + link: '/api' + }, + { + text: '配置容器镜像加速', + link: '/hub-mirror' + }, + { + text: '配置反向代理', + link: '/proxy' + }, + { + text: '配置进程守护', + link: '/supervisor' + }, + { + text: '配置 QUIC（HTTP3）', + link: '/quic' + }, + { + text: '配置 TLSv1.1 TLSv1', + link: '/tls' + }, + { + text: '安全性建议', + link: '/safe' + }, + ] +} \ No newline at end of file diff --git a/en/about.md b/en/about.md index 33c5329..bf3083e 100644 --- a/en/about.md +++ b/en/about.md @@ -30,10 +30,7 @@ const members = [ # About -## About RatPanel - -RatPanel is a professional server operation and maintenance management panel dedicated to providing users with simple, -efficient, and secure server management solutions. +RatPanel is a professional server operation and maintenance management panel dedicated to providing users with simple, efficient, and secure server management solutions. | Vision | Mission | Values | |----------------------------------------------------------|---------------------------------------------|---------------------------------------------------| diff --git a/en/advanced/api.md b/en/advanced/api.md index d4df920..32afddb 100644 --- a/en/advanced/api.md +++ b/en/advanced/api.md @@ -2,8 +2,7 @@ ## Overview -RatPanel provides a secure RESTful interface for interacting with the panel system. All API requests require HMAC-SHA256 -signature authentication to ensure the security and integrity of communications. +RatPanel provides a secure RESTful interface for interacting with the panel system. All API requests require HMAC-SHA256 signature authentication to ensure the security and integrity of communications. ## Basic Information @@ -13,8 +12,7 @@ signature authentication to ensure the security and integrity of communications. ## Authentication Mechanism -The API uses the HMAC-SHA256 signature algorithm for authentication. Each request must include the following HTTP -headers: +The API uses the HMAC-SHA256 signature algorithm for authentication. Each request must include the following HTTP headers: | Header Name | Description | |-----------------|------------------------------------------------------------------------------------------| @@ -652,8 +650,7 @@ sendApiRequest(); If you encounter signature verification failures, check: - Ensure you are using the correct API token and ID -- Check that the client and server times are accurate; timestamp differences greater than 300 seconds will cause - verification to fail +- Check that the client and server times are accurate; timestamp differences greater than 300 seconds will cause verification to fail - Ensure the request body hasn't been modified before or after signature calculation - Ensure the URL path is handled correctly; remember to remove the entry prefix when normalizing the path diff --git a/en/advanced/hub-mirror.md b/en/advanced/hub-mirror.md index ab0e293..6625a25 100644 --- a/en/advanced/hub-mirror.md +++ b/en/advanced/hub-mirror.md @@ -1,7 +1,6 @@ # Configure Container Image Acceleration -Due to certain reasons, domestic users in China may be unable to connect to Docker Hub to pull container images, thus -requiring image acceleration configuration. +Due to certain reasons, domestic users in China may be unable to connect to Docker Hub to pull container images, thus requiring image acceleration configuration. ## For Podman @@ -16,8 +15,7 @@ location = "docker.io" location = "docker.1ms.run" ``` -Where docker.1ms.run is the configured image acceleration address. You can refer to other tutorials to set up and use -it. +Where docker.1ms.run is the configured image acceleration address. You can refer to other tutorials to set up and use it. ## For Docker @@ -31,5 +29,4 @@ Add the following configuration and save: } ``` -Where https://docker.1ms.run is the configured image acceleration address. You can refer to other tutorials to set up -and use it. \ No newline at end of file +Where https://docker.1ms.run is the configured image acceleration address. You can refer to other tutorials to set up and use it. diff --git a/en/advanced/proxy.md b/en/advanced/proxy.md index b719073..9f20848 100644 --- a/en/advanced/proxy.md +++ b/en/advanced/proxy.md @@ -1,7 +1,5 @@ # Configure Reverse Proxy -RatPanel v2.4.10+ comes with a built-in reverse proxy configuration generator, which you can access through the top -right corner of the site rewrite configuration page. +RatPanel v2.4.10+ comes with a built-in reverse proxy configuration generator, which you can access through the top right corner of the site rewrite configuration page. -Note: If you encounter issues with static resources like CSS/JS not loading properly after setting up a reverse proxy, -please remove the **Do not log static files** section from the site's main configuration file. +Note: If you encounter issues with static resources like CSS/JS not loading properly after setting up a reverse proxy, please remove the **Do not log static files** section from the site's main configuration file. diff --git a/en/advanced/quic.md b/en/advanced/quic.md index 344263a..84c2a14 100644 --- a/en/advanced/quic.md +++ b/en/advanced/quic.md @@ -1,17 +1,15 @@ # Configure QUIC (HTTP3) -RatPanel currently supports automatic QUIC configuration, but for compatibility reasons, the `Alt-Svc` header is not -added by default. Browsers will not attempt to use QUIC connections without detecting the `Alt-Svc` header. +RatPanel currently supports automatic QUIC configuration, but for compatibility reasons, the `Alt-Svc` header is not added by default. Browsers will not attempt to use QUIC connections without detecting the `Alt-Svc` header. -If you are not using a CDN, you can add the configuration below to your website's rewrite rules to let browsers know -that the website supports and uses QUIC connections. +If you are not using a CDN, you can add the configuration below to your website's rewrite rules to let browsers know that the website supports and uses QUIC connections. ``` add_header Alt-Svc 'h3=":$server_port"; ma=2592000'; ``` If you are using a CDN or there are proxy servers in front, then QUIC needs to be enabled on the CDN / frontend. + If the configuration still doesn't work, please check your browser version and the availability of UDP port 443. -* According to Nginx's git commit history, all QUIC draft versions have been removed in version 1.25, so there's no need - to add draft version numbers to `Alt-Svc`. +* According to Nginx's git commit history, all QUIC draft versions have been removed in version 1.25, so there's no need to add draft version numbers to `Alt-Svc`. diff --git a/en/advanced/safe.md b/en/advanced/safe.md index 6b66bfb..ef2908c 100644 --- a/en/advanced/safe.md +++ b/en/advanced/safe.md @@ -4,15 +4,11 @@ With the following security measures, almost all hacking/malware issues can be p ### Website Aspects -Based on past experience, most hacking and malware incidents are caused by program vulnerabilities, unrelated to the -Panel or environment. For website security, you should: +Based on experience, most hacking and malware incidents are caused by program vulnerabilities, unrelated to the Panel or environment. For website security, you should: 1. Avoid using pirated programs or software, especially when you cannot determine if they have been tampered with. -2. Regularly update website programs and software environments; don't use outdated software due to inconvenience, as - their security cannot be guaranteed. -3. Never use weak passwords for website admin areas. Passwords are strongly recommended to be generated using a random - generator with more than 20 mixed characters and stored in a secure location. If possible, enable multi-factor - authentication (2FA) for your programs. +2. Regularly update website programs and software environments; don't use outdated software due to inconvenience, as their security cannot be guaranteed. +3. Never use weak passwords for website admin areas. Passwords are strongly recommended to be generated using a random generator with more than 20 mixed characters and stored in a secure location. If possible, enable 2FA for your programs. 4. Set up scheduled backups of all site data; don't operate without backups. 5. PHP has disabled some high-risk functions by default; don't remove these restrictions unless absolutely necessary. @@ -21,25 +17,16 @@ Panel or environment. For website security, you should: The probability of serious security vulnerabilities in modern systems is low, but you should still: 1. Regularly update system software. (Use `yum update` or `apt upgrade`). -2. Prohibit weak passwords and the default port 22 for SSH. Passwords are strongly recommended to be generated using a - random generator with more than 20 mixed characters and stored in a secure location. If possible, consider installing - Fail2ban for targeted protection. -3. Don't arbitrarily assign 777 permissions or execution permissions to the www user, as this may cause major security - risks. +2. Prohibit weak passwords and the default port 22 for SSH. Passwords are strongly recommended to be generated using a random generator with more than 20 mixed characters and stored in a secure location. If possible, consider installing Fail2ban for targeted protection. +3. Don't arbitrarily assign 777 permissions or execution permissions to the www user, as this may cause major security risks. 4. If your service provider offers VNC server management, consider disabling SSH to solve the problem at the source. ### Panel Aspects RatPanel has the same privileges as root, and improper management can cause serious security problems. You should: -1. Regularly update the Panel and applications installed through it. We recommend following our channel or group to - receive various update messages promptly. -2. Prohibit weak passwords and the default 8888 port for the Panel. Passwords are strongly recommended to be generated - using a random generator with more than 20 mixed characters and stored in a secure location. -3. Consider modifying the Panel entry point and enabling HTTPS for the Panel to prevent scanner detection and - man-in-the-middle attacks. -4. Unless necessary, do not allow firewall access to internal service ports (Redis 6379, MySQL 3306, PostgreSQL 5432, - etc.), as this may cause serious security risks. (Local website connections don't require firewall access; connection - issues are program problems). -5. For high-security requirements, consider stopping the Panel operation routinely and starting it only when needed ( - stopping the Panel will not affect websites, scheduled tasks, etc.). +1. Regularly update the Panel and applications installed through it. We recommend following our channel or group to receive various update messages promptly. +2. Prohibit weak passwords and the default 8888 port for the Panel. Passwords are strongly recommended to be generated using a random generator with more than 20 mixed characters and stored in a secure location. +3. Consider modifying the Panel entry point and enabling HTTPS for the Panel to prevent scanner detection and man-in-the-middle attacks. +4. Unless necessary, do not allow firewall access to internal service ports (Redis 6379, MySQL 3306, PostgreSQL 5432, etc.), as this may cause serious security risks. (Local website connections don't require firewall access; connection issues are program problems). +5. For high-security requirements, consider stopping the Panel operation routinely and starting it only when needed (stopping the Panel will not affect websites, scheduled tasks, etc.). diff --git a/en/advanced/supervisor.md b/en/advanced/supervisor.md index 6df9c5f..312e3da 100644 --- a/en/advanced/supervisor.md +++ b/en/advanced/supervisor.md @@ -1,6 +1,5 @@ # Configure Process Monitoring 1. Install Supervisor manager and open it. -2. Create processes that need to be monitored in the Supervisor manager (it's not recommended to use root as the running - user). +2. Create processes that need to be monitored in the Supervisor manager (it's not recommended to use root as the running user). 3. Common issues: [https://tom.moe/t/supervisor/3112](https://tom.moe/t/supervisor/3112) diff --git a/en/advanced/tls.md b/en/advanced/tls.md index 3c975d8..08cab0e 100644 --- a/en/advanced/tls.md +++ b/en/advanced/tls.md @@ -1,7 +1,6 @@ # Configure TLSv1.1 TLSv1 -The current Panel OpenResty is compiled with OpenSSL 3.5, which by default disables the deprecated TLSv1.1 and TLSv1 -protocols. +The current Panel OpenResty is compiled with OpenSSL 3.5, which by default disables the deprecated TLSv1.1 and TLSv1 protocols. Of course, if your business must use these two protocols, you can enable them using the SSL configuration below. @@ -9,4 +8,4 @@ Of course, if your business must use these two protocols, you can enable them us 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; -``` \ No newline at end of file +``` diff --git a/en/cert.md b/en/cert.md index 018145a..440fa8e 100644 --- a/en/cert.md +++ b/en/cert.md @@ -6,11 +6,9 @@ next: false # Certificates -If the 3-month free certificate cannot meet your needs, you can choose to purchase higher-level certificates. We offer -DV single-domain certificates and DV wildcard certificates for your selection. +If the 3-month free certificate cannot meet your needs, you can choose to purchase higher-level certificates. We offer DV single-domain certificates and DV wildcard certificates for your selection. -Due to pricing policy restrictions, please contact our sales team directly through the group link in the upper right -corner for specific prices and purchases. +Due to pricing policy restrictions, please contact our sales team directly through the group link in the upper right corner for specific prices and purchases. + +## 选购证书 + +
+
+
+

DV 单域名证书

+
+
国际知名品牌证书
+
¥ 1X/年
+
+
+ ✓ + 域名型证书（DV） +
+
+ ✓ + 支持一个域名 +
+
+ ✓ + 一年有效期 +
+
+ ✓ + 快速颁发 +
+
+ +
+
+
+

DV 通配符证书

+
+
国际知名品牌证书
+
¥ 1XX/年
+
+
+ ✓ + 域名型证书（DV） +
+
+ ✓ + 通配所有子域 +
+
+ ✓ + 一年有效期 +
+
+ ✓ + 快速颁发 +
+
+ +
+
+ +## 证书特点 + +
+
+
+
🛡️
+
+

安全可靠

+

采用国际标准，保护网站安全

+
+
+
+
⚡
+
+

快速签发

+

简化签发流程，快速颁发证书

+
+
+
+
💳
+
+

灵活付费

+

多种规格可选，满足不同需求

+
+
+
+
👨‍💻
+
+

专业服务

+

专业技术支持，保障使用无忧

+
+
+
+
diff --git a/zh_CN/index.md b/zh_CN/index.md new file mode 100644 index 0000000..d75a8f5 --- /dev/null +++ b/zh_CN/index.md @@ -0,0 +1,62 @@ +--- +layout: home + +hero: + name: "耗子面板" + text: "简单轻量 • 高效运维" + tagline: 全能服务器运维管理面板 + actions: + - theme: brand + text: 🌟 点亮 Star + link: https://github.com/tnb-labs/panel + target: _blank + - theme: alt + text: 快速安装 + link: /zh_CN/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: 承诺面板本体未来不会引入任何收费/授权功能，永久免费使用 +--- + +## 合作伙伴 + +
+ + 微晓朵 + + + 林枫云 + + + WAFPRO + + + 盾云SCDN + + + 毫秒镜像 + +
diff --git a/zh_CN/quickstart/container.md b/zh_CN/quickstart/container.md new file mode 100644 index 0000000..ed0009f --- /dev/null +++ b/zh_CN/quickstart/container.md @@ -0,0 +1,24 @@ +# 管理容器 + +开始前需安装 Docker / Podman 容器引擎。 + +容器引擎安装完毕后，即可前往面板容器管理处创建容器（此处以 pgadmin4 为例）。 + +首先导航到镜像选项卡拉取需要的镜像，视网络环境可能需要数分钟到数十分钟。 + +![拉取镜像](/container1.png) + +镜像拉取完成后，导航到容器选项卡开始创建容器。 + +![创建容器](/container2.png) + +表单内容按容器的说明填写，此处使用的 pgadmin4 镜像需要映射 80 端口及配置 2 个默认环境变量，无需映射目录。 + +容器创建完成后可点击右上角刷新按钮和容器右侧的日志按钮检查是否正常启动。 + +![容器启动](/container3.png) + +若容器未能启动，请根据日志进行修正。 +如果映射了外部端口，需要到防火墙菜单放行相应的端口。 + +![创建成功](/container4.png) diff --git a/zh_CN/quickstart/disk.md b/zh_CN/quickstart/disk.md new file mode 100644 index 0000000..10d75a8 --- /dev/null +++ b/zh_CN/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 +``` + +也可工单联系服务器提供商要求协助挂载分区，或者自行挂载分区后再安装面板。 diff --git a/zh_CN/quickstart/install.md b/zh_CN/quickstart/install.md new file mode 100644 index 0000000..7ac5396 --- /dev/null +++ b/zh_CN/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 分钟内即可完成安装，安装过程中请勿关闭终端。 diff --git a/zh_CN/quickstart/panel.md b/zh_CN/quickstart/panel.md new file mode 100644 index 0000000..c82757a --- /dev/null +++ b/zh_CN/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 +``` + +卸载面板前请务必备份好所有数据，提前卸载面板全部应用。卸载后数据将**无法恢复**！ diff --git a/zh_CN/support.md b/zh_CN/support.md new file mode 100644 index 0000000..85ca2e4 --- /dev/null +++ b/zh_CN/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) diff --git a/zh_CN/version-[version].md b/zh_CN/version-[version].md new file mode 100644 index 0000000..31a958e --- /dev/null +++ b/zh_CN/version-[version].md @@ -0,0 +1,8 @@ +# v{{ $params.version }} + +- 版本类型：{{ $params.type == 'stable' ? '稳定版' : '测试版' }} +- 发布时间：{{ $params.time }} + +## 更新内容 + + \ No newline at end of file diff --git a/zh_CN/version-[version].paths.ts b/zh_CN/version-[version].paths.ts new file mode 100644 index 0000000..c2d0186 --- /dev/null +++ b/zh_CN/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 + } + }) + } +} \ No newline at end of file