Skip to content

Commit 0a4c1cd

Browse files
authored
chore: add README file in Vietnamese (#226)
1 parent ce7ccb6 commit 0a4c1cd

File tree

2 files changed

+389
-1
lines changed

2 files changed

+389
-1
lines changed

README-vi_VN.md

Lines changed: 388 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,388 @@
1+
<div align="center">
2+
<img src="resources/logo.png" alt="Nginx UI Logo">
3+
</div>
4+
5+
# Nginx UI
6+
7+
Yet another Nginx Web UI, được phát triển bởi [0xJacky](https://jackyu.cn/)[Hintay](https://blog.kugeek.com/).
8+
9+
[![Build and Publish](https://github.com/0xJacky/nginx-ui/actions/workflows/build.yml/badge.svg)](https://github.com/0xJacky/nginx-ui/actions/workflows/build.yml)
10+
[![GitHub license](https://img.shields.io/github/license/0xJacky/nginx-ui?label=License&logo=github)](https://github.com/0xJacky/nginx-ui "Click to view the repo on Github")
11+
[![Release Version](https://img.shields.io/github/release/0xJacky/nginx-ui?include_prereleases&label=Release&logo=github)](https://github.com/0xJacky/nginx-ui/releases/latest "Click to view the repo on Github")
12+
[![GitHub Star](https://img.shields.io/github/stars/0xJacky/nginx-ui?label=Stars&logo=github)](https://github.com/0xJacky/nginx-ui "Click to view the repo on Github")
13+
[![GitHub Fork](https://img.shields.io/github/forks/0xJacky/nginx-ui?label=Forks&logo=github)](https://github.com/0xJacky/nginx-ui "Click to view the repo on Github")
14+
[![Repo Size](https://img.shields.io/github/repo-size/0xJacky/nginx-ui?label=Size&logo=github)](https://github.com/0xJacky/nginx-ui "Click to view the repo on Github")
15+
[![GitHub Fork](https://img.shields.io/github/issues-closed-raw/0xJacky/nginx-ui?label=Closed%20Issue&logo=github)](https://github.com/0xJacky/nginx-ui/issue "Click to view the repo on Github")
16+
17+
[![Docker Stars](https://img.shields.io/docker/stars/uozi/nginx-ui?label=Stars&logo=docker)](https://hub.docker.com/r/uozi/nginx-ui "Click to view the image on Docker Hub")
18+
[![Docker Pulls](https://img.shields.io/docker/pulls/uozi/nginx-ui?label=Pulls&logo=docker)](https://hub.docker.com/r/uozi/nginx-ui "Click to view the image on Docker Hub")
19+
[![Image Size](https://img.shields.io/docker/image-size/uozi/nginx-ui/latest?label=Image%20Size&logo=docker)](https://hub.docker.com/r/uozi/nginx-ui "Click to view the image on Docker Hub")
20+
21+
## Tài liệu
22+
Để xem tài liệu, hãy truy cập [nginxui.com](https://nginxui.com).
23+
24+
## Stargazers over time
25+
26+
[![Stargazers over time](https://starchart.cc/0xJacky/nginx-ui.svg)](https://starchart.cc/0xJacky/nginx-ui)
27+
28+
English | [Español](README-es.md) | [简体中文](README-zh_CN.md) | [繁體中文](README-zh_TW.md) | [Tiếng Việt](README-vi_VN.md)
29+
30+
<details>
31+
<summary>Mục lục</summary>
32+
<ol>
33+
<li>
34+
<a href="#about-the-project">Thông tin dự án</a>
35+
<ul>
36+
<li><a href="#demo">Demo</a></li>
37+
<li><a href="#features">Tính năng</a></li>
38+
<li><a href="#internationalization">Ngôn ngữ hiển thị</a></li>
39+
<li><a href="#built-with">Được xây dựng với</a></li>
40+
</ul>
41+
</li>
42+
<li>
43+
<a href="#getting-started">Bắt đầu</a>
44+
<ul>
45+
<li><a href="#before-use">Lưu ý trước khi sử dụng</a></li>
46+
<li><a href="#installation">Cài đặt</a></li>
47+
<li>
48+
<a href="#usage">Cách dùng</a>
49+
<ul>
50+
<li><a href="#from-executable">Sử dụng với Executable</a></li>
51+
<li><a href="#with-systemd">Sử dụng với Systemd</a></li>
52+
<li><a href="#with-docker">Sử dụng với Docker</a></li>
53+
</ul>
54+
</li>
55+
</ul>
56+
</li>
57+
<li>
58+
<a href="#manual-build">Build từ mã nguồn</a>
59+
<ul>
60+
<li><a href="#prerequisites">Điều kiện cần</a></li>
61+
<li><a href="#build-app">Build Frontend</a></li>
62+
<li><a href="#build-backend">Build Backend</a></li>
63+
</ul>
64+
</li>
65+
<li>
66+
<a href="#script-for-linux">Script cho Linux</a>
67+
<ul>
68+
<li><a href="#basic-usage">Sử dụng cơ bản</a></li>
69+
<li><a href="#more-usage">Sử dụng nâng cao</a></li>
70+
</ul>
71+
</li>
72+
<li><a href="#example-of-nginx-reverse-proxy-configuration">Ví dụ về cấu hình Nginx Reverse Proxy</a></li>
73+
<li><a href="#contributing">Đóng góp</a></li>
74+
<li><a href="#license">Giấy phép</a></li>
75+
</ol>
76+
</details>
77+
78+
## Về dự án
79+
80+
![Dashboard](resources/screenshots/dashboard_en.png)
81+
82+
### Demo
83+
URL:[https://demo.nginxui.com](https://demo.nginxui.com)
84+
- Username:admin
85+
- Password:admin
86+
87+
### Tính năng
88+
89+
- Thống kê trực tuyến cho các chỉ số máy chủ như mức sử dụng CPU, mức sử dụng bộ nhớ, mức tải trung bình và mức sử dụng ổ đĩa.
90+
- Chat với trợ lý ChatGPT
91+
- Triển khai bằng một cú nhấp chuột và tự động gia hạn chứng chỉ Let's Encrypt.
92+
- Chỉnh sửa cấu hình Nginx từ UI với **NgxConfigEditor** tự thiết kế của chúng tôi, một trình chỉnh sửa khối thân thiện với người dùng cho cấu hình nginx hoặc **Ace Code Editor** hỗ trợ làm nổi bật cú pháp cấu hình nginx.
93+
- Xem Nginx logs
94+
- Được viết bằng Go và Vue, và được phân phối với một tệp nhị phân thực thi duy nhất.
95+
- Tự động kiểm tra file cấu hình và tải lại nginx sau khi lưu cấu hình.
96+
- Web Terminal
97+
- Dark Mode
98+
- Responsive Web Design
99+
100+
### Ngôn ngữ hiển thị
101+
102+
- Tiếng Việt
103+
- Tiếng Anh
104+
- Tiếng Nga
105+
- Tiếng Pháp
106+
- Tiếng Tây Ban Nha
107+
- Tiếng Trung giản thể
108+
- Tiếng Trung phồn thể
109+
110+
Chúng tôi hoan nghênh bản dịch sang bất kỳ ngôn ngữ nào.
111+
112+
### Được xây dựng với
113+
114+
- [The Go Programming Language](https://go.dev)
115+
- [Gin Web Framework](https://gin-gonic.com)
116+
- [GORM](http://gorm.io)
117+
- [Vue 3](https://v3.vuejs.org)
118+
- [Vite](https://vitejs.dev)
119+
- [TypeScript](https://www.typescriptlang.org/)
120+
- [Ant Design Vue](https://antdv.com)
121+
- [vue3-gettext](https://github.com/jshmrtn/vue3-gettext)
122+
- [vue3-ace-editor](https://github.com/CarterLi/vue3-ace-editor)
123+
- [Gonginx](https://github.com/tufanbarisyildirim/gonginx)
124+
125+
## Bắt đầu
126+
127+
### Lưu ý trước khi sử dụng
128+
129+
Máy chủ của bạn sẽ cần phải cài Nginx trước khi cài đặt Nginx UI
130+
131+
Nginx UI tuân theo tiêu chuẩn tệp cấu hình máy chủ web Debian. Các tệp cấu hình trang web đã tạo sẽ được đặt trong thư mục /etc/nginx/sites-available (được phát hiện tự động). Các tệp cấu hình cho một trang web được kích hoạt sẽ tạo một symlink đến thư mục /etc/nginx/sites-enabled. Bạn có thể cần điều chỉnh cách sắp xếp các tệp cấu hình của mình.
132+
133+
Đối với các hệ thống không phải Debian (và Ubuntu), bạn có thể cần thay đổi nội dung của tệp cấu hình nginx.conf thành kiểu Debian như hiển thị bên dưới.
134+
135+
```nginx
136+
http {
137+
# ...
138+
include /etc/nginx/conf.d/*.conf;
139+
include /etc/nginx/sites-enabled/*;
140+
}
141+
```
142+
143+
Để biết thêm thông tin: [debian/conf/nginx.conf](https://salsa.debian.org/nginx-team/nginx/-/blob/master/debian/conf/nginx.conf#L59-L60)
144+
145+
### Cài đặt
146+
147+
Giao diện người dùng Nginx có sẵn trên các nền tảng sau:
148+
149+
- Mac OS X 10.10 Yosemite and later (amd64 / arm64)
150+
- Linux 2.6.23 and later (x86 / amd64 / arm64 / armv5 / armv6 / armv7)
151+
- Bao gồm nhưng không giới hạn Debian 7/8, Ubuntu 12.04/14.04 trở lên, CentOS 6/7, Arch Linux
152+
- FreeBSD
153+
- OpenBSD
154+
- Dragonfly BSD
155+
- Openwrt
156+
157+
Bạn có thể truy cập [latest release](https://github.com/0xJacky/nginx-ui/releases/latest) để tải xuống bản phân phối mới nhất hoặc sử dụng [Tập lệnh cài đặt cho Linux](#script-for-linux).
158+
159+
### Sử dụng
160+
161+
Trong lần chạy đầu tiên, vui lòng truy cập `http://<your_server_ip>:<listen_port>/install` bằng trình duyệt của bạn để hoàn tất các cấu hình.
162+
163+
#### Chạy với Executable
164+
**Chạy giao diện người dùng Nginx trong Terminal**
165+
166+
```shell
167+
nginx-ui -config app.ini
168+
```
169+
Bấm `Ctrl + C` vào terminal để thoát Nginx UI.
170+
171+
**Chạy nền (Background)**
172+
173+
```shell
174+
nohup ./nginx-ui -config app.ini &
175+
```
176+
Dừng Nginx UI bằng lệnh sau.
177+
178+
```shell
179+
kill -9 $(ps -aux | grep nginx-ui | grep -v grep | awk '{print $2}')
180+
```
181+
182+
#### Chạy với Systemd
183+
Nếu bạn sử dụng [tập lệnh cài đặt cho Linux](#script-for-linux), Nginx UI sẽ được cài đặt dưới dạng `nginx-ui` service trong systemd. Hãy sử dụng `systemctl` để điều khiển nó.
184+
185+
**Start Nginx UI**
186+
187+
```shell
188+
systemctl start nginx-ui
189+
```
190+
**Stop Nginx UI**
191+
192+
```shell
193+
systemctl stop nginx-ui
194+
```
195+
**Restart Nginx UI**
196+
197+
```shell
198+
systemctl restart nginx-ui
199+
```
200+
201+
#### Sử dụng với Docker
202+
Docker image của chúng tôi [uozi/nginx-ui:latest](https://hub.docker.com/r/uozi/nginx-ui) dựa trên nginx image mới nhất và có thể được sử dụng để thay thế Nginx trên máy chủ. Bằng cách xuất bản cổng 80 và 443 của container, bạn có thể dễ dàng thực hiện chuyển đổi.
203+
204+
##### Ghi chú
205+
1. Khi khởi chạy container lần đầu tiên, hãy chắc chắn thư mục /etc/nginx trên máy host là rỗng.
206+
2. Nếu bạn muốn lưu trữ các tệp tĩnh, bạn có thể mount các thư mục vào container.
207+
208+
<details>
209+
<summary><b>Triển khai với Docker</b></summary>
210+
211+
1. [Cài đặt Docker.](https://docs.docker.com/install/)
212+
213+
2. Sau đó triển khai nginx-ui như thế sau:
214+
215+
```bash
216+
docker run -dit \
217+
--name=nginx-ui \
218+
--restart=always \
219+
-e TZ=Asia/Shanghai \
220+
-v /mnt/user/appdata/nginx:/etc/nginx \
221+
-v /mnt/user/appdata/nginx-ui:/etc/nginx-ui \
222+
-p 8080:80 -p 8443:443 \
223+
uozi/nginx-ui:latest
224+
```
225+
226+
3. Khi container đã hoạt động, truy cập vào trang quản trị nginx-ui theo liên kết `http://<your_server_ip>:8080/install`.
227+
</details>
228+
229+
<details>
230+
<summary><b>Triển khai với Docker-Compose</b></summary>
231+
232+
1. [Cài đặt Docker-Compose.](https://docs.docker.com/compose/install/)
233+
234+
2. Tạo tệp docker-compose.yml:
235+
236+
```yml
237+
version: '3.3'
238+
services:
239+
nginx-ui:
240+
stdin_open: true
241+
tty: true
242+
container_name: nginx-ui
243+
restart: always
244+
environment:
245+
- TZ=Asia/Shanghai
246+
volumes:
247+
- '/mnt/user/appdata/nginx:/etc/nginx'
248+
- '/mnt/user/appdata/nginx-ui:/etc/nginx-ui'
249+
- '/var/www:/var/www'
250+
ports:
251+
- 8080:80
252+
- 8443:443
253+
image: 'uozi/nginx-ui:latest'
254+
```
255+
256+
3. Sau đó tạo container bằng lệnh:
257+
258+
```bash
259+
docker-compose up -d
260+
```
261+
262+
Nếu bạn sử dụng docker-compose-plugin, lệnh sẽ như sau
263+
264+
```bash
265+
266+
docker compose up -d
267+
```
268+
269+
4. Khi container đã hoạt động, truy cập vào trang quản trị nginx-ui theo liên kết `http://<your_server_ip>:8080/install`.
270+
271+
</details>
272+
273+
## Xây dựng thủ công
274+
275+
Trên các nền tảng không có phiên bản xây dựng chính thức, chúng có thể được xây dựng thủ công.
276+
277+
### Điều kiện cần
278+
279+
- Make
280+
- Golang 1.19+
281+
- node.js 18+
282+
283+
```shell
284+
npx browserslist@latest --update-db
285+
```
286+
287+
### Build Frontend
288+
289+
Vui lòng thực hiện lệnh sau trong thư mục `app`.
290+
291+
```shell
292+
yarn install
293+
yarn build
294+
```
295+
296+
### Build Backend
297+
298+
Vui lòng build Frontend trước, sau đó thực hiện lệnh sau trong thư mục gốc của dự án.
299+
300+
```shell
301+
go build -o nginx-ui -v main.go
302+
```
303+
304+
## Tập lệnh cho Linux
305+
306+
### Cách sử dụng cơ bản
307+
308+
**Cài đặt và nâng cấp**
309+
310+
```shell
311+
bash <(curl -L -s https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh) install
312+
```
313+
Port mặc định để truy cập UI là `9000`, port HTTP Challenge mặc định để xác thực SSL là `9180`.
314+
Nếu có xung đột port, vui lòng sửa đổi trong file `/usr/local/etc/nginx-ui/app.ini`,
315+
hãy nhớ restart nginx-ui bằng lệnh `systemctl restart nginx-ui` mỗi khi bạn sửa đổi file app.ini.
316+
317+
**Gỡ bỏ Nginx UI nhưng giữ lại các tệp cấu hình và cơ sở dữ liệu**
318+
319+
```shell
320+
bash <(curl -L -s https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh) remove
321+
```
322+
323+
**Gỡ bỏ Nginx UI đồng thời xoá các tệp cấu hình, cơ sở dữ liệu**
324+
325+
```shell
326+
bash <(curl -L -s https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh) remove --purge
327+
```
328+
329+
### Trợ giúp
330+
331+
````shell
332+
bash <(curl -L -s https://raw.githubusercontent.com/0xJacky/nginx-ui/master/install.sh) help
333+
````
334+
335+
## Ví dụ về cấu hình Nginx Reverse Proxy
336+
337+
```nginx
338+
server {
339+
listen 80;
340+
listen [::]:80;
341+
342+
server_name <your_server_name>;
343+
rewrite ^(.*)$ https://$host$1 permanent;
344+
}
345+
346+
map $http_upgrade $connection_upgrade {
347+
default upgrade;
348+
'' close;
349+
}
350+
351+
server {
352+
listen 443 ssl;
353+
listen [::]:443 ssl;
354+
http2 on;
355+
356+
server_name <your_server_name>;
357+
358+
ssl_certificate /path/to/ssl_cert;
359+
ssl_certificate_key /path/to/ssl_cert_key;
360+
361+
location / {
362+
proxy_set_header Host $host;
363+
proxy_set_header X-Real-IP $remote_addr;
364+
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
365+
proxy_set_header X-Forwarded-Proto $scheme;
366+
proxy_http_version 1.1;
367+
proxy_set_header Upgrade $http_upgrade;
368+
proxy_set_header Connection $connection_upgrade;
369+
proxy_pass http://127.0.0.1:9000/;
370+
}
371+
}
372+
```
373+
374+
## Đóng góp
375+
376+
Đóng góp là điều khiến cộng đồng nguồn mở trở thành một nơi tuyệt vời để học hỏi, truyền cảm hứng và sáng tạo. Bất kỳ đóng góp nào bạn thực hiện đều được **đánh giá cao**.
377+
378+
Nếu bạn có đề xuất giúp dự án tốt hơn, vui lòng phân nhánh repo và tạo pull request. Bạn cũng có thể mở một issue mới với thẻ "enhancement" để đề xuất tính năng. Đừng quên cho dự án một Star! Cảm ơn một lần nữa!
379+
380+
1. Fork dự án
381+
2. Tạo Branch (`git checkout -b feature/AmazingFeature`)
382+
3. Commit thay đổi (`git commit -m 'Add some AmazingFeature'`)
383+
4. Đẩy code lên Branch (`git push origin feature/AmazingFeature`)
384+
5. Mở một Pull Request
385+
386+
## Giấy phép
387+
388+
Dự án này được cung cấp theo giấy phép GNU Affero General Public License v3.0 có thể tìm thấy trong tệp [LICENSE](LICENSE). Bằng cách sử dụng, phân phối hoặc đóng góp cho dự án này, bạn đồng ý với các điều khoản và điều kiện của giấy phép này.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ To check out docs, visit [nginxui.com](https://nginxui.com).
2525

2626
[![Stargazers over time](https://starchart.cc/0xJacky/nginx-ui.svg)](https://starchart.cc/0xJacky/nginx-ui)
2727

28-
English | [Español](README-es.md) | [简体中文](README-zh_CN.md) | [繁體中文](README-zh_TW.md)
28+
English | [Español](README-es.md) | [简体中文](README-zh_CN.md) | [繁體中文](README-zh_TW.md) | [Tiếng Việt](README-vi_VN.md)
2929

3030
<details>
3131
<summary>Table of Contents</summary>

0 commit comments

Comments
 (0)