# rakuten

**Repository Path**: bkmantou/rakuten

## Basic Information

- **Project Name**: rakuten
- **Description**: No description available
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-10
- **Last Updated**: 2026-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rakuten / OCN 管理项目

本仓库包含 OCN 邮箱管理客户端，以及配套的 SISICC 任务管控后台。

## 目录

- `outputs/ocn_mail_manager.py`：PyQt6 Windows 客户端源码
- `outputs/rakuten_control/`：Flask 管控服务
- `outputs/rakuten_control_admin/`：Vue 3 管理端

客户端任务默认使用 IPWO 日本动态代理端点；先在 IPWO 控制台完成公网 IP 白名单，必要时在后台“代理设置”粘贴控制台生成的完整 API 地址覆盖。也可通过 `IPWO_API_URL` 覆盖。可选设置 `IPWO_ZONE`（例如 `zone_JP` 或 `zone_US_st_California_city_LosAngeles`）；每个邮箱任务都会单独提取并测试一个代理，成功后才启动浏览器流程，任务记录会保存代理 IP、地区、获取时间和测试状态。

IPWO 代理认证账号和密码由后台“代理设置”写入 SISICC/Yudao 系统字典 `rakuten_ipwo_proxy`，客户端在每个任务开始前通过任务服务读取。首次部署可执行 `outputs/ipwo_proxy_dict_mysql.sql` 创建字典类型和两条空数据；API 地址、地区和协议仍按 `outputs/rakuten_control/.env.example` 中的 IPWO 环境变量配置。
- `outputs/README.md`：客户端功能、运行和部署说明
- `outputs/build_windows.bat`：Windows 客户端编译脚本

## 管理后台开发

```powershell
cd outputs/rakuten_control_admin
npm install
npm run build
```

Flask 服务依赖安装：

```powershell
python -m pip install -r outputs/rakuten_control/requirements.txt
```

真实账号密码、Cookie、数据库文件、运行日志和编译产物不会提交到仓库；请根据部署环境配置 `.env`。

## Jenkins 自动编译发布

仓库根目录的 `Jenkinsfile` 会完成 Flask 语法检查、Vue 构建、发布包归档、SSH 部署和公网健康检查。当前仓库没有硬编码 Jenkins 或 Gitee 密码；请在 Jenkins 凭证管理中创建：

- `gitee-rakuten-http`：Gitee 用户名/密码凭证，用于拉取 `https://gitee.com/bkmantou/rakuten.git`
- `rakuten-prod-ssh`：生产服务器 SSH 私钥凭证，建议使用密钥登录，不要把服务器密码写进流水线

Jenkins 节点需要安装 Python 3、Node.js/npm、`tar`、`curl`，并安装 Pipeline、Credentials Binding、SSH Agent 插件。流水线默认构建 `feature/ipwo-proxy-integration`，发布到 `rakuten.sisicc.com`，远程服务为 `rakuten-control`。线上 `.env` 不会被流水线覆盖，发布前会自动备份到 `/opt/rakuten-backups/<timestamp>/`。

Jenkins API 自动触发使用 `tools/trigger_jenkins.py`。请给 Jenkins 用户创建 API Token，并通过环境变量传入；不要使用或保存 Jenkins 登录密码：

```powershell
$env:JENKINS_URL = "https://jenkins.example.com"
$env:JENKINS_JOB = "rakuten-release"
$env:JENKINS_USER = "yangyao"
$env:JENKINS_API_TOKEN = "<Jenkins API Token>"
python tools/trigger_jenkins.py --branch feature/ipwo-proxy-integration
```

Gitee 账号和密码只应录入 Jenkins 的 `gitee-rakuten-http` 凭证页面，不能写入 `Jenkinsfile`、脚本、日志或 Git 提交。