Files
tyapi-server/scripts/README_admin_token.md
2025-08-02 19:58:14 +08:00

93 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 管理员Token生成脚本使用说明
## 概述
`generate_admin_token_simple.go` 是一个用于生成管理员JWT token的脚本方便管理员登录用户账号进行查看和调试。
## 功能特性
- 支持通过环境变量自定义用户信息
- 自动加载项目配置文件
- 生成标准的JWT token
- 提供详细的使用说明和示例
## 使用方法
### 直接运行
```bash
cd tyapi-server-gin
go run scripts/generate_admin_token_simple.go
```
### 固定用户信息
脚本中已预设了以下用户信息:
- 用户ID: `admin_user_001`
- 手机号: `13800138000`
- 邮箱: `admin@example.com`
- 用户类型: `admin`
如需修改用户信息,请直接编辑脚本中的相应变量。
## 输出示例
```
=== 管理员Token生成成功 ===
用户ID: admin_user_001
手机号: 13800138000
邮箱: admin@example.com
用户类型: admin
过期时间: 24h0m0s
=== Token ===
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
=== 使用说明 ===
在API请求的Authorization头部中使用:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
=== 示例curl命令 ===
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." http://localhost:8080/api/v1/user/profile
```
## 使用场景
1. **管理员调试**: 管理员需要以特定用户身份登录系统进行调试
2. **用户问题排查**: 管理员需要查看特定用户的数据和操作
3. **API测试**: 开发人员需要测试不同用户类型的API权限
4. **系统维护**: 在系统维护时需要以特定用户身份执行操作
## 安全注意事项
⚠️ **重要提醒**:
- 此脚本仅用于开发和调试环境
- 生产环境中请勿使用此脚本
- 生成的token具有完整的用户权限请妥善保管
- 使用完毕后请及时删除或过期token
## 编译为可执行文件
如果需要频繁使用,可以编译为可执行文件:
```bash
# 编译
go build -o bin/generate-admin-token scripts/generate_admin_token_simple.go
# 使用
./bin/generate-admin-token
```
## 故障排除
### 1. 配置文件找不到
确保在项目根目录下运行脚本,或者确保 `config.yaml` 文件存在。
### 2. 权限错误
确保脚本有读取配置文件的权限。
### 3. 依赖问题
确保所有Go依赖都已正确安装
```bash
go mod tidy
```