# AI平台账号卡密管理系统

**Repository Path**: Blight001/AI_server

## Basic Information

- **Project Name**: AI平台账号卡密管理系统
- **Description**: 本项目是一个全栈应用程序，旨在管理 AI 平台账号、处理代理服务以及监控流量使用情况。项目包含现代化的 Vue 3 前端和强大的 Flask (Python) 后端。

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-08-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Crack - Backserve 父仓库

本仓库是**父仓库**（Umbrella / Meta Repository），通过 Git Submodules 聚合管理三个独立的子仓库。

> **重要说明**：父仓库本身**不包含**子仓库的具体文件内容。  
> 子仓库的内容由各自的 Git 仓库独立管理，父仓库仅记录各子仓库在特定提交的引用指针。

## 包含的子仓库

| 本地路径     | 远程仓库地址                                      | 说明          |
|--------------|---------------------------------------------------|---------------|
| server_main  | https://gitee.com/Blight001/server_main.git      | 主服务        |
| server_middle| https://gitee.com/Blight001/server_middle.git    | 中间层服务    |
| server_web   | https://gitee.com/Blight001/server_web.git       | Web 前端      |

## 克隆整个项目（推荐）

父仓库地址：https://gitee.com/Blight001/AI_server.git

```bash
git clone --recurse-submodules https://gitee.com/Blight001/AI_server.git
cd backserve
```

如果已经普通克隆了父仓库，初始化子模块：

```bash
git submodule update --init --recursive
```

## 日常开发流程

1. **修改子项目代码**
   - 进入对应子目录，例如 `cd server_main`
   - 正常编辑、commit、push（推送到各自的远程仓库）

2. **在父仓库中更新子模块指针**（当子仓库有新提交时）
   ```bash
   # 更新所有子模块到远程最新
   git submodule update --remote --merge

   # 或者单独更新某个
   # cd server_main && git pull && cd ..

   # 提交父仓库的指针更新
   git add server_main server_middle server_web
   git commit -m "chore: update submodules"
   git push
   ```

3. **添加新的子仓库**（以后如有需要）
   ```bash
   git submodule add <远程仓库URL> <本地路径>
   git commit -m "add new submodule"
   ```

## 目录结构

```
.
├── .gitmodules
├── README.md
├── .gitignore
├── server_main/      # 子模块 (main backend)
├── server_middle/    # 子模块 (middle layer)
└── server_web/       # 子模块 (frontend)
```

## 注意事项

- 不要直接在父仓库根目录对子目录内的文件执行 `git add`（子目录由子模块管理）。
- 父仓库的 `.gitignore` 主要用于忽略父级可能产生的临时文件，子项目自己的忽略规则由各子仓库的 `.gitignore` 控制。
- 推荐使用 `git clone --recurse-submodules` 或初始化后使用 IDE 的 Git 子模块支持。

## Linux 服务器启动

无参数运行会进入交互式管理菜单：

```bash
chmod +x start_3end.sh
./start_3end.sh
# 即使使用 sh start_3end.sh，也会自动切换到 Bash。
```

现有服务器仓库存在本地修改、需要直接以远程版本覆盖时（不提交、不暂存）：

```bash
FORCE_GIT_OVERWRITE=1 bash start_3end.sh deploy
```

该命令会从远程获取父仓库版本并执行 `reset --hard`，再以 checkout 模式强制同步子模块；已跟踪的本地修改会永久丢失，未跟踪文件会保留。从外层引导脚本进入交互部署、检测到目标仓库有已跟踪修改时，也会先列出文件并请求确认。

脚本通过独立系统控制台按注册表启动统一网关、全部已启用租户、Middle 和 Web。
默认租户端口池为 `58210-58409`，可容纳 100 个独立平台：

```bash
TENANT_PORT_BASE=60000 TENANT_PORT_CAPACITY=200 ./start_3end.sh
```

查看防火墙和云安全组清单（只打印，不修改）：

```bash
./start_3end.sh ports
```

租户端口默认只绑定 `127.0.0.1`，无需公网开放。系统控制台 `59005` 默认绑定 `0.0.0.0`，启动或执行防火墙命令时会对所有来源开放：

```bash
sudo ./start_3end.sh firewall
./start_3end.sh start
```

`59005` 拥有服务控制、更新和数据导入导出能力。对公网部署时，请确保应用层管理凭据足够强，并同步在云安全组中放行 TCP `59005`。

如需将当前结构改回普通多文件夹方式或有其他需求，请联系维护者。