Jelajahi Sumber

docs(wip): added docs of config

0xJacky 2 tahun lalu
induk
melakukan
fda04b9576

+ 12 - 1
frontend/docs/.vitepress/config.ts

@@ -15,7 +15,6 @@ export default defineConfig({
         nav: [
             {text: 'Home', link: '/'},
             {text: 'Guide', link: '/guide/about'},
-            {text: 'Reference', link: '/reference/api-examples'},
             {text: 'Demo', link: 'https://nginxui.jackyu.cn'}
         ],
 
@@ -30,10 +29,22 @@ export default defineConfig({
                         {text: 'Contributing', link: '/guide/contributing'},
                         {text: 'License', link: '/guide/license'}
                     ]
+                },
+                {
+                    text: 'Configuration',
+                    items: [
+                        {text: 'Server', link: '/guide/config-server'},
+                        {text: 'Nginx Log', link: '/guide/config-nginx-log'},
+                        {text: 'Open AI', link: '/guide/config-openai'}
+                    ]
                 }
             ]
         },
 
+        search: {
+            provider: 'local'
+        },
+
         footer: {
             message: 'Released under the AGPL-3.0 License.',
             copyright: 'Copyright © 2021-' + thisYear() + ' Nginx UI Team'

+ 1 - 1
frontend/docs/guide/about.md

@@ -1,6 +1,6 @@
 # What is Nginx UI?
 
-![Dashboard](../public/dashboard_en.png)
+![Dashboard](/dashboard_en.png)
 
 Nginx UI is a comprehensive web-based interface designed to simplify the management and configuration of Nginx servers.
 It offers real-time server statistics, AI-powered ChatGPT assistance, one-click deployment, automatic renewal of Let's

+ 18 - 0
frontend/docs/guide/config-nginx-log.md

@@ -0,0 +1,18 @@
+# Nginx Log
+
+Nginx logs are essential for monitoring, troubleshooting, and maintaining your web server. They provide valuable
+insights into server performance, user behavior, and potential issues. In this section, we will discuss the two primary
+types of logs: access logs and error logs.
+
+## AccessLogPath
+
+- Type: `string`
+
+This option is used to set the path of nginx access log for Nginx UI, so we can view the log content online.
+
+## ErrorLogPath
+
+- Type: `string`
+
+This option is used to set the path of nginx error log for Nginx UI, so we can view the log content online.
+

+ 32 - 0
frontend/docs/guide/config-openai.md

@@ -0,0 +1,32 @@
+# Open AI
+
+This section is for setting up ChatGPT configurations. Please be aware that we do not check the accuracy of the
+information you provide. If the configuration is incorrect, it might cause API request failures, making the ChatGPT
+assistant unusable.
+
+## BaseUrl
+
+- Type: `string`
+
+This option is used to set the base url of the api of Open AI, leave it blank if you do not need to change the url.
+
+## Token
+
+- Type: `string`
+
+This option is used to set the token of the api of Open AI.
+
+## Proxy
+
+- Type: `string`
+
+This option is used to configure the proxy for OpenAI's API. If you are unable to access OpenAI's API in your country or
+region, you can use an HTTP proxy and set this option to the corresponding URL.
+
+## Model
+
+- Type: `string`
+- Default: `gpt-3.5-turbo`
+
+This option is used to set the ChatGPT model. If your account has the privilege to access the gpt-4 model, you can
+configure this option accordingly.

+ 79 - 0
frontend/docs/guide/config-server.md

@@ -0,0 +1,79 @@
+# Server
+
+The server section of the Nginx UI configuration deals with various settings that control the behavior and operation of
+the Nginx UI server. In this section, we will discuss the available options, their default values, and their purpose.
+
+## HttpPort
+
+- Type: `int`
+- Default: `9000`
+
+Nginx UI server listen port. This option is used to configure the port on which the Nginx UI server listens for incoming
+HTTP requests. Changing the default port can be useful for avoiding port conflicts or enhancing security.
+
+## RunMode
+
+- Type: `string`
+- Supported value: `release`, `debug`
+
+::: tip
+At present, we have not yet adapted to this option, and there will be no significant differences between release and
+debug in terms of usage.
+:::
+
+## HTTPChallengePort
+
+- Type: `int`
+- Default: `9180`
+
+This option is used to set the port for backend listening in the HTTP01 challenge mode when obtaining Let's Encrypt
+certificates. The HTTP01 challenge is a domain validation method used by Let's Encrypt to verify that you control the
+domain for which you're requesting a certificate.
+
+## Database
+
+- Type: `string`
+- Default: `database`
+
+This option is used to set the name of the sqlite database used by Nginx UI to store its data.
+
+## StartCmd
+
+- Type: `string`
+- Default: `login`
+
+This option is used to set the start command of the web terminal.
+
+::: warning
+For security reason, we use `login` as the start command, so you have to log in via the default authentication method of
+the Linux. If you don't want to enter your username and password for verification every time you access the web
+terminal, please set it to `bash` or `zsh` (if installed).
+:::
+
+## PageSize
+
+- Type: `int`
+- Default: 10
+
+This option is used to set the page size of list pagination in the Nginx UI. Adjusting the page size can help in
+managing large amounts of data more effectively.
+
+## CADir
+
+- Type: `string`
+
+When applying for a Let's Encrypt certificate, we use the default CA address of Let's Encrypt. If you need to debug or
+obtain certificates from other providers, you can set CADir to their address.
+
+::: tip
+Please note that the address provided by
+CADir needs to comply with the `RFC 8555` standard.
+:::
+
+## GithubProxy
+
+- Type: `string`
+- Suggestion: `https://ghproxy.com/`
+
+For users in mainland China who may experience difficulties downloading resources from Github, this option allows them
+to set a proxy for github.com to improve accessibility.

TEMPAT SAMPAH
frontend/docs/public/favicon.ico


+ 0 - 49
frontend/docs/reference/api-examples.md

@@ -1,49 +0,0 @@
----
-outline: deep
----
-
-# Runtime API Examples
-
-This page demonstrates usage of some of the runtime APIs provided by VitePress.
-
-The main `useData()` API can be used to access site, theme, and page data for the current page. It works in both `.md` and `.vue` files:
-
-```md
-<script setup>
-import { useData } from 'vitepress'
-
-const { theme, page, frontmatter } = useData()
-</script>
-
-## Results
-
-### Theme Data
-<pre>{{ theme }}</pre>
-
-### Page Data
-<pre>{{ page }}</pre>
-
-### Page Frontmatter
-<pre>{{ frontmatter }}</pre>
-```
-
-<script setup>
-import { useData } from 'vitepress'
-
-const { site, theme, page, frontmatter } = useData()
-</script>
-
-## Results
-
-### Theme Data
-<pre>{{ theme }}</pre>
-
-### Page Data
-<pre>{{ page }}</pre>
-
-### Page Frontmatter
-<pre>{{ frontmatter }}</pre>
-
-## More
-
-Check out the documentation for the [full list of runtime APIs](https://vitepress.dev/reference/runtime-api#usedata).