增加postgres储存

Author: su-kaka

.env.example

@@ -56,6 +56,13 @@ REDIS_URI=redis://localhost:6379
 # 默认: 0
 REDIS_DATABASE=0
 
+# ----------------------------
+# Postgres (关系型存储，优先级低于 Redis)
+# 配置 POSTGRES_DSN，用于在未启用 Redis 时作为分布式存储
+# 示例 DSN: postgresql://user:password@localhost:5432/gcli2api
+# ----------------------------
+# POSTGRES_DSN=postgresql://user:password@localhost:5432/gcli2api
+
 # MongoDB 分布式存储模式配置 (第二优先级)
 # 设置 MONGODB_URI 后自动启用 MongoDB 模式，不再使用本地文件存储
 
@@ -239,4 +246,4 @@ ANTI_TRUNCATION_MAX_ATTEMPTS=3
 # 
 # [auto_ban]
 # auto_ban_enabled = false
-# auto_ban_error_codes = [400, 403]
+# auto_ban_error_codes = [400, 403]

README.md

@@ -296,7 +296,7 @@ docker run -d --name gcli2api --network host -e API_PASSWORD=api_pwd -e PANEL_PA
 
 ### 🌟 存储后端优先级
 
-gcli2api 支持多种存储后端，按优先级自动选择：**Redis > MongoDB > 本地文件**
+gcli2api 支持多种存储后端，按优先级自动选择：**Redis > Postgres > MongoDB > 本地文件**
 
 ### ⚡ Redis 分布式存储模式
 
@@ -326,6 +326,26 @@ export REDIS_DATABASE="1"
 python web.py
 ```
 
+### 🐘 Postgres 分布式存储模式
+
+如果未配置 Redis，或者你希望使用关系型数据库作为主要存储方案，gcli2api 也支持 Postgres（位于 Redis 之后，优先于 MongoDB）。
+
+⚙️ 启用 Postgres 模式
+
+步骤 1: 配置 Postgres 连接
+```bash
+# 使用标准 DSN（示例）
+export POSTGRES_DSN="postgresql://user:password@localhost:5432/gcli2api"
+
+# 也可以使用 socket 或其他 DSN 格式，取决于你的部署方式
+```
+
+步骤 2: 启动应用
+```bash
+# 应用会自动检测 POSTGRES_DSN 并在 Redis 未启用时优先使用 Postgres 存储
+python web.py
+```
+
 ### 🍃 MongoDB 分布式存储模式
 
 ### 🌟 备选存储方案

docs/README_EN.md

@@ -294,7 +294,7 @@ docker run -d --name gcli2api --network host -e API_PASSWORD=api_pwd -e PANEL_PA
 
 ### 🌟 Storage Backend Priority
 
-gcli2api supports multiple storage backends, automatically selecting by priority: **Redis > MongoDB > Local Files**
+gcli2api supports multiple storage backends, automatically selecting by priority: **Redis > Postgres > MongoDB > Local Files**
 
 ### ⚡ Redis Distributed Storage Mode
 
@@ -324,6 +324,24 @@ export REDIS_DATABASE="1"
 python web.py
 ```
 
+### 🐘 Postgres Distributed Storage Mode
+
+If Redis is not configured, or you prefer a relational database, gcli2api also supports Postgres (it is checked after Redis and before MongoDB).
+
+⚙️ Enable Postgres Mode
+
+Step 1: Configure Postgres DSN
+```bash
+# Example DSN:
+export POSTGRES_DSN="postgresql://user:password@localhost:5432/gcli2api"
+```
+
+Step 2: Start Application
+```bash
+# Application will detect POSTGRES_DSN and use Postgres when Redis is not available
+python web.py
+```
+
 ### 🍃 MongoDB Distributed Storage Mode
 
 ### 🌟 Alternative Storage Solution
@@ -814,4 +832,4 @@ This project is for learning and research purposes only. Using this project indi
 - Bear all risks and responsibilities of using this project
 - Comply with relevant terms of service and legal regulations
 
-The project authors are not responsible for any direct or indirect losses arising from the use of this project.
+The project authors are not responsible for any direct or indirect losses arising from the use of this project.

pyproject.toml

@@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
     "aiofiles>=24.1.0",
+    "asyncpg>=0.30.0",
     "fastapi>=0.116.1",
     "httpx[socks]>=0.28.1",
     "hypercorn>=0.17.3",

requirements-termux.txt

@@ -9,4 +9,5 @@ toml
 PyJWT
 oauthlib
 motor
-redis
+redis
+asyncpg

requirements.txt

@@ -9,4 +9,5 @@ toml
 PyJWT
 oauthlib
 motor
-redis
+redis
+asyncpg