docs(wip): added docs of config

This commit is contained in:
0xJacky 2023-05-01 01:08:05 +08:00
parent ce98641614
commit fda04b9576
No known key found for this signature in database
GPG key ID: B6E4A6E4A561BAF0
7 changed files with 142 additions and 51 deletions

View file

@ -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'

View file

@ -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

View file

@ -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.

View file

@ -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.

View file

@ -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.

Binary file not shown.

After

Width:  |  Height:  |  Size: 66 KiB

View file

@ -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).