momentry_studio/docs/DEFAULT_PASSWORD_SYSTEM.md

# 默认用户密码系统

**更新时间**: 2026-10-12  
**状态**: ✅ 已实现动态密码系统

---

## 🎯 目标

**消除硬编码的默认密码 `demo123`，实现每次安装时自动生成唯一密码**

---

## ✅ 实现内容

### 1. 密码生成策略

**优先级顺序**:

1. **环境变量 `MOMENTRY_DEFAULT_PASSWORD`** (最高优先级)
   - 手动设置：`export MOMENTRY_DEFAULT_PASSWORD=my_secure_password`
   - 自动生成：`demo_<timestamp>`

2. **自动生成随机密码** (如果环境变量未设置)
   - 格式：`demo_<6位随机数>`
   - 示例：`demo_123456`, `demo_789012`

---

### 2. 修改的文件

#### `src-tauri/src/db.rs`

**修改内容**:
```rust
// 旧代码 (硬编码)
let default_password = "demo123";

// 新代码 (动态密码)
let default_password = std::env::var("MOMENTRY_DEFAULT_PASSWORD")
    .unwrap_or_else(|_| {
        use std::time::{SystemTime, UNIX_EPOCH};
        let timestamp = SystemTime::now()
            .duration_since(UNIX_EPOCH)
            .unwrap()
            .as_secs();
        format!("demo_{}", timestamp % 1000000)  // demo_123456
    });
```

**新增功能**:
- 首次创建用户时，打印默认密码到控制台
- 提示用户保存密码

---

#### `src-tauri/src/main.rs`

**SMB 服务密码修改**:
```rust
// 旧代码 (硬编码)
format!("... --user demo:demo123 ...")

// 新代码 (动态密码)
let smb_user = std::env::var("SMB_USER").unwrap_or_else(|_| "demo".to_string());
let smb_password = std::env::var("SMB_PASSWORD")
    .or_else(|_| std::env::var("MOMENTRY_DEFAULT_PASSWORD"))
    .unwrap_or_else(|_| {
        // Fallback to a generated password
        use std::time::{SystemTime, UNIX_EPOCH};
        let timestamp = SystemTime::now()
            .duration_since(UNIX_EPOCH)
            .unwrap()
            .as_secs();
        format!("smb_{}", timestamp % 1000000)
    });
format!("... --user {}:{} ...", smb_user, smb_password)
```

---

### 3. 新增工具

#### `src-tauri/src/bin/user_tool.rs`

**用户管理命令行工具**:

```bash
# 列出所有用户
./user_tool list

# 创建新用户
./user_tool create <username> <password>

# 修改用户密码
./user_tool set-password <username> <password>

# 删除用户
./user_tool delete <username>

# 初始化 demo 用户
./user_tool init-demo
```

**特点**:
- 独立可执行文件，不依赖 Tauri 运行时
- 支持从环境变量读取默认密码
- 支持密码哈希（Argon2id）

---

### 4. 安装脚本更新

#### `install.sh`

**新增步骤 5.5**: 初始化默认用户

```bash
# 生成安全随机密码
DEFAULT_PASSWORD="demo_$(openssl rand -hex 4)"

# 设置环境变量
export MOMENTRY_DEFAULT_PASSWORD="${DEFAULT_PASSWORD}"

# 保存到 .env 文件
echo "MOMENTRY_DEFAULT_PASSWORD=${DEFAULT_PASSWORD}" >> .env

# 初始化数据库
./src-tauri/target/release/user_tool init-demo
```

**输出示例**:
```
========================================
Demo user initialized:
  Username: demo
  Password: demo_a1b2c3d4
========================================
```

---

### 5. 配置文件更新

#### `.env.template`

```bash
# ========================================
# 默认用户密码
# ========================================
# 在安装时自动生成，或手动设置
# 格式: demo_<random>
MOMENTRY_DEFAULT_PASSWORD=demo_change_this

# ========================================
# SMB 共享配置
# ========================================
SMB_USER=demo
SMB_PASSWORD=${MOMENTRY_DEFAULT_PASSWORD}
```

---

## 📊 架构对比

### 旧架构 (硬编码)

```
安装时
  └─> 硬编码密码: demo123
      └─> 所有安装使用相同密码
          └─> 安全风险高 ❌
```

---

### 新架构 (动态密码)

```
安装时
  ├─> 检查环境变量 MOMENTRY_DEFAULT_PASSWORD
  │   ├─> 已设置 → 使用该值
  │   └─> 未设置 → 生成随机密码
  │
  ├─> 保存到 .env 文件
  │
  └─> 初始化数据库
      └─> 用户看到生成的密码
          └─> 每次安装密码唯一 ✅
```

---

## 🔐 密码存储位置

### SQLite 数据库

**路径**: `data/users/demo.sqlite`

**表结构**:
```sql
CREATE TABLE app_users (
    id TEXT PRIMARY KEY,
    username TEXT NOT NULL UNIQUE,
    password_hash TEXT,          -- Argon2id 哈希
    display_name TEXT,
    role TEXT DEFAULT 'user',
    created_at TEXT,
    updated_at TEXT
);
```

**存储方式**:
- 密码使用 Argon2id 算法哈希
- **不存储明文密码**
- 哈希格式：`$argon2id$v=19$m=19456,t=2,p=1$...`

---

### .env 文件

**路径**: `momentry_studio/.env`

**内容**:
```bash
MOMENTRY_DEFAULT_PASSWORD=demo_a1b2c3d4
```

**用途**:
- 首次启动时读取
- 传递给 SMB 服务
- 方便管理员查看

**安全性**:
- ⚠️ 文件权限应为 `600` (仅所有者可读写)
- ⚠️ 不要提交到 Git (已在 `.gitignore`)

---

## 🚀 使用流程

### 1. 自动安装 (推荐)

```bash
# 运行安装脚本
./install.sh

# 输出示例:
# ========================================
# Default user password: demo_a1b2c3d4
# Please save this password securely!
# ========================================
```

**脚本会自动**:
- 生成随机密码
- 保存到 `.env`
- 初始化数据库
- 打印密码给用户

---

### 2. 手动设置密码

```bash
# 设置环境变量
export MOMENTRY_DEFAULT_PASSWORD=my_secure_password

# 运行安装
./install.sh

# 或手动初始化
./src-tauri/target/release/user_tool init-demo
```

---

### 3. 查看用户列表

```bash
./src-tauri/target/release/user_tool list

# 输出:
# Users:
# ID         Username        Display Name         Role
# ------------------------------------------------------------
# demo       demo            Demo User            admin
```

---

### 4. 修改密码

```bash
./src-tauri/target/release/user_tool set-password demo new_password_123

# 输出:
# ✅ Password updated for user 'demo'
```

---

### 5. 创建新用户

```bash
./src-tauri/target/release/user_tool create admin secure_pass_456

# 输出:
# ✅ User 'admin' created successfully
```

---

## 📝 部署到新环境

### m4promini 环境

```bash
# 1. 克隆代码
cd ~
git clone <repo_url> momentry_studio

# 2. 运行安装
cd momentry_studio
./install.sh

# 3. 记录生成的密码 (例如: demo_a1b2c3d4)

# 4. 启动服务
./start.sh
```

**系统会自动**:
- 检测用户主目录：`/Users/nextorageai`
- 创建数据目录：`~/momentry/var/sftpgo/data`
- 生成唯一密码：`demo_<random>`
- 初始化 demo 用户

---

## ⚠️ 安全注意事项

### 1. 密码管理

✅ **推荐做法**:
- 使用强密码 (至少 12 位)
- 定期更换密码
- 不同环境使用不同密码
- 将 `.env` 文件权限设为 `600`

❌ **不推荐做法**:
- 使用硬编码密码
- 在代码中存储明文密码
- 多个环境共用相同密码

---

### 2. 文件权限

```bash
# 设置 .env 文件权限
chmod 600 .env

# 设置数据库文件权限
chmod 600 data/users/demo.sqlite
```

---

### 3. 环境隔离

每个环境应有独立的密码：

| 环境 | 用户 | 密码 | 配置文件 |
|-----|------|------|---------|
| m5max48 | demo | `demo_a1b2c3` | `/Users/accusys/momentry_studio/.env` |
| m4promini | demo | `demo_x9y8z7` | `/Users/nextorageai/momentry_studio/.env` |
| 生产环境 | demo | `demo_prod_...` | `/opt/momentry/.env` |

---

## 🛠️ 故障排除

### 问题 1: 忘记密码

```bash
# 方法 1: 查看 .env 文件
cat .env | grep MOMENTRY_DEFAULT_PASSWORD

# 方法 2: 重置密码
./src-tauri/target/release/user_tool set-password demo new_password
```

---

### 问题 2: 数据库初始化失败

```bash
# 检查数据库目录
ls -la data/users/

# 手动创建目录
mkdir -p data/users

# 重新初始化
./src-tauri/target/release/user_tool init-demo
```

---

### 问题 3: SMB 服务无法连接

```bash
# 检查 SMB 密码配置
cat .env | grep SMB_PASSWORD

# 确保密码一致
export SMB_PASSWORD=${MOMENTRY_DEFAULT_PASSWORD}

# 重启 SMB 服务
./src-tauri/target/release/momentry-studio  # 或通过 GUI
```

---

## 📊 检查清单

在部署前确认：

- [ ] `.env` 文件已创建并包含 `MOMENTRY_DEFAULT_PASSWORD`
- [ ] `.env` 文件权限为 `600`
- [ ] 数据库文件已初始化
- [ ] demo 用户密码已记录
- [ ] SMB 密码已配置（如需 SMB 服务）
- [ ] 不同环境使用不同密码
- [ ] `.env` 文件已添加到 `.gitignore`

---

## 🎉 总结

### 改进前

- ❌ 硬编码密码 `demo123`
- ❌ 所有安装使用相同密码
- ❌ 无法自定义密码
- ❌ 安全风险高

---

### 改进后

- ✅ 动态生成唯一密码
- ✅ 每次安装密码独立
- ✅ 支持自定义密码
- ✅ 密码哈希存储
- ✅ 用户管理工具
- ✅ 安装自动化

---

**文档位置**: `docs/DEFAULT_PASSWORD_SYSTEM.md`  
**Commit**: 待提交  
**Status**: ✅ 已实现动态密码系统