快速开始
本指南将帮助您在 10 分钟内快速启动 MITM Service。
前置要求
在开始之前，请确保您的系统已安装：
- Docker 20.10+
- Docker Compose 1.29+
- Git
快速启动
1. 克隆仓库
git clone https://github.com/yourusername/mitm-service.git
cd mitm-service
2. 环境配置
复制环境变量模板：
# Web Service
cp web-service/.env.example web-service/.env
# Cookie Manager
cp cookie-manager/.env.example cookie-manager/.env
编辑环境变量文件，至少配置以下内容：
# MySQL 配置
DB_HOST=mysql
DB_PORT=3306
DB_USER=root
DB_PASSWORD=your_password
DB_NAME=mitm_service
# Redis 配置
REDIS_HOST=redis
REDIS_PORT=6379
# JWT 密钥
JWT_SECRET=your-secret-key-change-this
3. 启动服务
使用 Docker Compose 一键启动所有服务：
docker-compose up -d
等待所有服务启动完成（约 1-2 分钟）。
4. 验证服务
检查服务状态：
docker-compose ps
您应该看到以下服务都处于 Up 状态：
mysql- 数据库服务redis- 缓存服务web-service- Web API 服务cookie-manager- Cookie 管理服务mitm-proxy- 代理服务nginx- Web 服务器
5. 访问服务
- API 服务: http://localhost:80/api
- 浏览器扩展API: http://localhost:80/ext-api
6. 测试 API
创建测试用户：
curl -X POST http://localhost/api/auth/register \
-H "Content-Type: application/json" \
-d '{
"username": "testuser",
"email": "[email protected]",
"password": "Test123456"
}'
登录获取 Token：
curl -X POST http://localhost/api/auth/login \
-H "Content-Type: application/json" \
-d '{
"username": "testuser",
"password": "Test123456"
}'
开发模式
如果您想在开发模式下运行：
1. 启动基础服务
docker-compose up -d mysql redis
2. 安装依赖
# Web Service
cd web-service
npm install
# Cookie Manager
cd ../cookie-manager
npm install
# Browser Extension
cd ../browser-ext
npm install
3. 启动开发服务器
在不同终端窗口中：
# Terminal 1: Web Service
cd web-service
npm run dev
# Terminal 2: Cookie Manager
cd cookie-manager
npm run dev
# Terminal 3: MITM Proxy
cd mitm-ext
python launch.py --mode http --listen-port 8080
# Terminal 4: Browser Extension
cd browser-ext
npm run dev
配置代理
浏览器代理设置
配置浏览器使用 MITM Proxy：
手动配置:
- HTTP Proxy:
localhost:8080 - HTTPS Proxy:
localhost:8080
证书安装:
- 启动 MITM Proxy 后访问 http://mitm.it
- 根据您的操作系统下载并安装证书
- 信任该证书
系统代理设置
macOS:
networksetup -setwebproxy "Wi-Fi" localhost 8080
networksetup -setsecurewebproxy "Wi-Fi" localhost 8080
Linux (使用 export):
export http_proxy=http://localhost:8080
export https_proxy=http://localhost:8080
常见问题
端口冲突
如果端口被占用，编辑 docker-compose.yml 修改端口映射：
services:
web-service:
ports:
- "3000:3000" # 修改左侧端口号
数据库连接失败
检查 MySQL 服务是否正常：
docker-compose logs mysql
确保环境变量配置正确。
服务无法启动
查看服务日志：
docker-compose logs [service-name]
下一步
获取帮助
如果遇到问题：