# openvpn3

**Repository Path**: wendal/openvpn3

## Basic Information

- **Project Name**: openvpn3
- **Description**: 简单但可用的图形化OpenVPN管理端
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-31
- **Last Updated**: 2026-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VPN Manager - OpenVPN 多用户管理平台

基于 Python FastAPI + React + OpenVPN 的企业级 VPN 服务器管理平台。

## 特性

- 多用户、多设备管理
- 多网段支持（每个网段独立 OpenVPN 实例）
- Web 管理界面（React + Ant Design）
- HTTP API 下发 OpenVPN 客户端配置
- 内置 CA 证书管理（自动签发/吊销）
- UDP/TCP 协议支持
- 跨平台部署（Linux systemd / Windows NSSM）
- 后端升级不中断 VPN 连接

## 技术栈

| 组件 | 技术 |
|------|------|
| 后端 | Python 3.11+ / FastAPI |
| 前端 | React 18 + Vite + TypeScript + Ant Design |
| 数据库 | SQLite (SQLAlchemy ORM) |
| VPN | OpenVPN 2.5+ |
| 部署 | Linux: systemd / Windows: NSSM |

## 快速开始

### Linux 部署

```bash
sudo ./deploy/scripts/install_linux.sh
```

### Windows 部署

```powershell
.\deploy\scripts\install_windows.ps1
```

### 开发模式

```bash
# 后端
cd server
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

# 前端
cd web
npm install
npm run dev
```

## 默认配置

- 管理后台: http://localhost:8000
- 默认管理员: admin / admin（首次登录需修改密码）
- 默认网段: 10.8.0.0/16 (UDP, 端口 1194)

## 文档

- [架构设计](docs/architecture.md)
- [API 接口文档](docs/api-design.md)
- [部署文档](docs/deployment.md)

## 许可证

MIT