# nginx-template

**Repository Path**: deepeye/nginx-template

## Basic Information

- **Project Name**: nginx-template
- **Description**: nginx template
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nginx代理模板

一套标准化的Nginx配置模板，支持HTTP和TCP代理，适用于openEuler 22.03和Ubuntu 22部署。

## 功能特性

- HTTP反向代理（API服务）
- 静态文件服务
- HTTPS/SSL支持
- TCP代理（数据库、gRPC、WebSocket）
- 模块化配置，易于维护

## 快速开始

### openEuler 22.03

```bash
cd deploy/openeuler22.03
chmod +x install.sh setup.sh
./install.sh    # 安装nginx
./setup.sh      # 部署配置
```

### Ubuntu 22

```bash
cd deploy/ubuntu22
chmod +x install.sh setup.sh
./install.sh    # 安装nginx
./setup.sh      # 部署配置
```

## 目录结构

```
nginx-template/
├── config/           # 配置模板文件
│   ├── http/         # HTTP代理模板
│   ├── tcp/          # TCP代理模板
│   ├── snippets/     # 配置片段
│   └── nginx.conf.template  # 主配置
├── deploy/           # 部署脚本
│   ├── openeuler22.03/  # openEuler 22.03脚本
│   └── ubuntu22/     # Ubuntu 22脚本
├── examples/         # 完整示例
└── README.md         # 说明文档
```

## 使用说明

1. 安装nginx（执行install.sh）
2. 部署配置模板（执行setup.sh）
3. 根据需求修改配置文件（替换域名、地址等）
4. 验证配置（nginx -t）
5. 重载nginx服务（systemctl reload nginx）

## 配置说明

### HTTP代理配置

| 模板文件 | 用途 |
|----------|------|
| api-proxy.conf.template | API反向代理 |
| static-files.conf.template | 静态文件服务 |
| ssl.conf.template | HTTPS配置 |

### TCP代理配置

| 模板文件 | 用途 |
|----------|------|
| database-proxy.conf.template | 数据库代理（MySQL/PostgreSQL） |
| grpc-proxy.conf.template | gRPC微服务代理 |
| websocket-proxy.conf.template | WebSocket实时通信 |

### 配置片段

| 文件 | 内容 |
|------|------|
| logging.conf | 基础日志配置 |
| ssl-params.conf | SSL安全参数 |
| proxy-params.conf | 代理通用参数 |

## 修改配置要点

使用模板时需要替换的内容：

- `server_name` - 替换为实际域名
- `server` 地址 - 替换为后端服务IP和端口
- `root` 路径 - 替换为静态文件实际路径
- `ssl_certificate` - 替换为SSL证书实际路径

## 安全说明

- SSL配置使用TLSv1.2+，禁用不安全协议
- 采用行业推荐的强加密套件
- 日志记录便于安全审计

## 扩展建议

可根据实际需求扩展：

- 健康检查配置
- 限流策略
- 缓存配置
- 监控集成（nginx状态页）

## 生产环境样例

### 示例：端口80双服务代理

配置文件：`examples/production.conf`

| 服务 | 后端地址 | 路径 |
|------|----------|------|
| 党媒评论H5 | 10.19.2.213:8081 | /xbyp |
| Dify | 10.19.2.215 | / (默认) |

部署步骤：

```bash
# 1. 复制配置到nginx配置目录
sudo cp examples/production.conf /etc/nginx/conf.d/

# 2. 验证配置
sudo nginx -t

# 3. 启动nginx
sudo systemctl start nginx
sudo systemctl enable nginx

# 4. 测试服务
curl http://localhost/health
curl http://localhost/xbyp
curl http://localhost/
```