# axum_service

**Repository Path**: num_13/axum

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Axum 用户认证 REST API

基于 Rust Axum 框架构建的 REST API 项目，提供用户注册、登录和认证功能。

## 功能特性

- **用户注册** - 支持新用户创建账户
- **用户登录** - 账号密码认证，返回 JWT 令牌
- **JWT 认证** - 基于 Token 的身份验证
- **受保护路由** - 需要认证才能访问的接口
- **健康检查** - 服务健康状态查询

## 技术栈

- **Rust** - 编程语言
- **Axum** - Web 框架
- **SQLx** - 数据库 ORM
- **PostgreSQL** - 数据库
- **jsonwebtoken** - JWT 生成与验证

## 快速开始

### 环境要求

- Rust 1.70+
- PostgreSQL

### 配置

1. 复制环境配置示例：

```bash
cp .env.example .env
```

2. 编辑 `.env` 文件，配置数据库连接和 JWT 密钥。

### 运行

```bash
cargo run
```

服务默认运行在 `http://127.0.0.1:3000`

## API 接口

### 注册用户

```http
POST /auth/register
Content-Type: application/json

{
  "username": "your_username",
  "password": "your_password"
}
```

### 用户登录

```http
POST /auth/login
Content-Type: application/json

{
  "username": "your_username",
  "password": "your_password"
}
```

### 获取当前用户信息（需认证）

```http
GET /api/me
Authorization