# 小於菟 Mtranserver WebUI

**Repository Path**: Gitree-XiaoWuTu_admin/xiaowutu-mtranserver-web-ui

## Basic Information

- **Project Name**: 小於菟 Mtranserver WebUI
- **Description**: Mtranserver本地翻译服务器的开源网页UI
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-14
- **Last Updated**: 2025-08-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 小於菟 MTranServer Web UI

MTranServer翻译服务Web前端界面，支持基础翻译功能与授权码管理。
MTranServer仓库地址：https://github.com/xxnuo/MTranServer

## 功能简介
- 提供翻译界面，支持中英互译
- 单个ip地址的翻译次数限制
- 管理员可查看翻译记录与生成/管理授权码
- 前端历史记录保存与导出
可点击体验：[小於菟 MTranServer Web UI](https://translate.xiaowutu.top/)

## 技术栈
- Python (Flask)
- HTML5 + JavaScript等
- MySQL 数据库
- 前端压缩使用pako.js

## 安装说明
1. 安装依赖
```bash
pip install -r requirements.txt
```

2. 配置数据库、翻译接口信息 (config.py)
```python
MTRAN_HOST = "127.0.0.1:233" # 您的MTranServer地址
CORE_API_TOKEN = "" # 您的MTranServer API TOKEN（如有）
#数据库设置
DB_HOST = '127.0.0.1'
DB_USER = 'translation'
DB_PASSWORD = 'xxx'
DB_NAME = 'translation_db'
ADMIN_TOKEN = 'xxx'
```

3. 初始化数据库
无需手动初始化。

4. 启动服务
```bash
python app.py
```

## 使用说明
- 普通用户访问
  1. 打开浏览器访问 http://localhost:5000
  2. 输入文本点击翻译
  3. 历史记录自动保存

- 管理员功能
  1. 访问 http://localhost:5000/admin
  2. 输入管理员令牌进入管理界面
  3. 可查看/导出翻译记录，生成授权码

## 特性
- 智能IP限流（可自己修改，默认23小时内限制翻译33次）
- 支持管理员颁发授权码兑换解除限制
- 翻译记录审计追踪
- 响应式设计适配移动端
- 翻译记录保存与导出

## 开源协议
本项目采用 GNU Affero General Public License v3 开源协议

完整协议请查看 [LICENSE](LICENSE) 文件

## 目录结构
```
.
├── app.py          # Flask主程序
├── config.py       # 配置文件
├── templates/
│   ├── admin.html  # 管理界面模板
│   └── index.html # 主界面模板
├── requirements.txt # Python依赖
└── LICENSE         # 开源协议文件
```