nginx-proxy-manager-zh/README.md
2024-12-29 16:00:37 +08:00

132 lines
3.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[Original English README](https://github.com/xiaoxinpro/nginx-proxy-manager-zh/blob/develop-zh/README-en.md)
<p align="center">
<img src="https://nginxproxymanager.com/github.png">
<br>
</p>
本项目是基于 [NginxProxyManager/nginx-proxy-manager](https://github.com/NginxProxyManager/nginx-proxy-manager) 翻译的中文版本该项目属于一个预构建的docker映像它可以让你轻松地部署到你的网站上运行包括免费的SSL而不需要知道太多关于 Nginx 或 Let's Encrypt 的信息。
![](http://image.xiaoxin.pro/2022/05/16/75687b5bfffbe.png)
## 快速部署
### 1. 环境部署
安装Docker和Docker-compose
- [Docker官方安装文档英文](https://docs.docker.com/install/)
- [Docker-Compose官方安装文档英文](https://docs.docker.com/compose/install/)
- **[Docker和Docker-compose安装文档中文](https://blog.csdn.net/zhangzejin3883/article/details/124778945)**
### 2. 创建YAML文件
创建一个 `docker-compose.yml` 文件:
```yml
version: '3'
services:
app:
image: 'chishin/nginx-proxy-manager-zh:release'
restart: always
ports:
- '80:80'
- '81:81'
- '443:443'
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
```
### 3. 部署运行
```bash
docker-compose up -d
```
### 4. 登录管理页面
当你的docker容器成功运行使用浏览器访问`81`端口。
有些时候需要稍等一段时间。
[http://127.0.0.1:81](http://127.0.0.1:81)
默认管理员信息:
```
Email: admin@example.com
Password: changeme
```
使用这个默认用户登录后,系统会立即要求您修改详细信息和密码。
### 5. 快速升级
```bash
docker-compose down
docker-compose pull
docker-compose up -d
```
这个项目将自动更新任何数据库或其他要求所以你不必遵循任何疯狂的指示。上面的这些步骤将提取最新的更新并重新创建docker容器。
## 更多
### 1. 官方文档(英文)
关于本应用的更多用法请访问官方文档:
- [项目源码](https://github.com/NginxProxyManager/nginx-proxy-manager)
- [项目官网](https://nginxproxymanager.com/)
- [安装手册](https://nginxproxymanager.com/setup/)
- [高级配置](https://nginxproxymanager.com/advanced-config/#best-practice-use-a-docker-network)
- [常见问题](https://nginxproxymanager.com/faq/#do-i-have-to-use-docker)
### 2. 替换中文镜像
当你使用官方示例的`docker-compose`时需要注意将image镜像`jc21/nginx-proxy-manager`替换为`chishin/nginx-proxy-manager-zh`即可实现中文部署。
### 3. 关于中文镜像
中文镜像并没有重新构建后端代码,由[Dockerfile-zh](https://github.com/xiaoxinpro/nginx-proxy-manager-zh/blob/develop-zh/docker/Dockerfile-zh)文件可以得知,中文镜像基于官方镜像替换前端代码来实现的,所以中文版本的全部功能与官方版本完全相同,只是显示界面的文字不同的区别。
### 4. 关于DNSPod创建证书失败
此问题在2.9.19版本开始就已经存在,原因是`zope`引起的由于ARM架构一直安装失败所以无法打包到镜像中建议使用如下方法修复此问题
首先确保nginx-proxy-manager-zh的Docker容器已经正常运行使用`docker-compose ps`查看容器名,这里假设容器名为`npm-zh`。
进入容器:(注意替换下文中的容器名)
```
docker exec -it npm-zh bash
```
执行安装`zope`命令:
```
python3 -m pip install --upgrade pip
pip install certbot-dns-dnspod
pip install zope
```
等待安装完成,退出容器:
```
exit
```
最后刷新浏览器再次使用DNSPod创建证书即可。
## 捐赠
如果您觉得本项目对你有帮助,欢迎给予我们一定的捐助来翻译项目的长期发展。
### 支付宝扫码捐赠
![支付宝扫码捐赠](https://image.xiaoxin.pro/2022/05/16/1f1a5f025c13c.png)
### 微信扫描捐赠
![微信扫描捐赠](https://image.xiaoxin.pro/2022/05/16/9c9906b102b29.png)