Admin SDK (Python)

独立的管理员 SDK，用于管理用户、Token、代理、指纹和模板。不依赖 linege-sdk-python。

安装

pip install https://pub-69fcb37602174d10b2152f09439de470.r2.dev/sdk/linege_admin-0.2.1-py3-none-any.whl

开发模式：

cd packages/linege-admin-python
pip install -e ".[dev]"

快速开始

from linege_admin import LinegeAdmin

admin = LinegeAdmin(
    api_url="https://api.sybilslayer.com",
    token="your-admin-token",
)

# 查看用户列表
users = admin.list_users()
for u in users.users:
    print(f"{u.username} quota={u.quota_used}/{u.quota_total}")

# 从 CSV 导入代理
result = admin.import_proxies_csv("JP,socks5://1.2.3.4:1080\nUS,http://5.6.7.8:8080")
print(f"Inserted: {result.inserted}")

# 国家就绪矩阵
matrix = admin.get_country_matrix()
for c in matrix.countries:
    print(f"{c.code}: ready={c.ok}")

环境变量

变量	说明	默认值
LINEGE_API_URL	API 基础地址	http://localhost:3000
LINEGE_ADMIN_TOKEN	管理员 Token	(必填)

---

API 参考

构造函数

LinegeAdmin(api_url: str, token: str, timeout: float = 30.0)

用户管理

方法	说明
list_users(page, limit)	分页列出用户
create_user(username, email, password, quota_total)	创建用户
update_user(user_id, *, quota_total, password, status, email)	更新用户
delete_user(user_id)	删除用户（级联清理）
generate_test_accounts(...)	批量生成测试账户
get_uuid_ip_map(limit, include_inactive)	UUID-IP 对应表
export_uuid_ip_map(save_path, limit, include_inactive)	导出 CSV

Token 管理

方法	说明
list_tokens(page, limit)	分页列出 Token
create_token(user_id, name, expires_in_days)	创建 Token
revoke_token(token_id)	吊销 Token

代理管理

方法	说明
list_proxies(country, status, limit)	列出代理
get_proxy_stats()	代理统计
recheck_proxies(country, limit)	批量重检代理
import_proxies(items)	JSON 批量导入
import_proxies_csv(csv, default_country)	CSV 批量导入

指纹与模板

方法	说明
import_templates(items)	批量导入模板
import_fingerprints(items)	批量导入指纹
get_fingerprint_stats()	指纹统计

国家矩阵

方法	说明
get_country_matrix()	国家就绪矩阵（模板+代理）

---

完整示例

python examples/example_full.py \
  --api-url https://api.sybilslayer.com \
  --token YOUR_ADMIN_TOKEN

覆盖全部 18 个端点（19 个方法），包含正常路径与清理逻辑。