🚀 快速开始

安装

预编译安装

下载对应架构的压缩包并解压：

wget https://download.liumou.site/PasswordReset/v2.0.1/PasswordReset-client-linux-X86_64.tar.gz
tar xzf PasswordReset-client-linux-X86_64.tar.gz

其他版本和平台的下载链接请访问 下载中心。

::: important 安装方式说明 使用 -service-install 安装服务时，程序会自动完成以下操作：

• 将二进制复制到 /usr/local/bin/PasswordReset（权限 0700，仅 root 可执行）
• 创建软链接 /usr/sbin/PasswordReset → /usr/local/bin/PasswordReset，确保直接输入命令即可执行
• 创建 systemd 服务文件（带安全加固指令）
• 无需手动 install 或 chmod，服务安装后即可在任何位置使用 PasswordReset 命令 :::

首次使用

1️⃣ 添加用户

添加用户时需要为每个用户设置独立的安全密钥(userKey)，密钥支持交互输入或从文件读取（8-32字符，不含特殊符号）：

# 解压后首次使用（需要指定解压出的文件名）
sudo ./PasswordReset_linux-X86_64 -add-user=admin -add

# 也可配合其他属性
sudo ./PasswordReset_linux-X86_64 -add-user=admin -add -sudo-nopasswd -allow-ssh

::: important 安全设计 每个用户拥有独立的安全密钥(userKey，8-32字符)，支持交互输入或从文件读取。

• 交互输入（推荐）：直接粘贴，不会回显到终端
• 从文件读取：文件仅允许一行内容，读取后自动删除源文件
• 密钥不允许包含管道符 |、重定向 <>、命令替换等特殊符号 :::

2️⃣ 安装服务

使用程序自带的 -service-install 命令安装，无需手动创建 systemd 文件：

# 安装系统服务，每6小时重置一次密码
sudo ./PasswordReset_linux-X86_64 -service-install -hour=6

# 安装后直接使用 PasswordReset 命令
sudo PasswordReset -list-users
sudo PasswordReset -add-user=newuser -add

# 查看服务状态
sudo systemctl status PasswordReset.timer
sudo systemctl status PasswordReset.service

服务安装说明

• Linux：自动创建 systemd timer + oneshot 服务，由 timer 周期触发密码重置
• Windows：自动注册 Windows SC 服务
• 二进制安装到 /usr/local/bin/PasswordReset，创建软链接 /usr/sbin/PasswordReset
• 服务安装后，直接输入 PasswordReset 即可执行，无需再指定路径
• 服务运行使用最小权限原则：ProtectSystem=strict、PrivateTmp=true、NoNewPrivileges=true
• 配置目录 /etc/PasswordReset/ 权限 0700，仅 root 可访问
• 密钥文件权限 0600，仅 root 可读写

3️⃣ 配置上报监控（可选）

安装服务时指定监控服务器地址，客户端会自动上报密码修改状态：

# 不校验 API Key
sudo PasswordReset -service-install -hour=6 \
  -report-server=http://monitor.example.com:12396

# 带 API Key 校验
sudo PasswordReset -service-install -hour=6 \
  -report-server=http://monitor.example.com:12396 \
  -report-api-key=my-secret-key

监控面板的部署方式请参考 监控面板。

4️⃣ 查询当前密码

密码查询请通过 Web 服务进行：

• 公共查询平台：https://encrypt.liumou.site/
• 私有部署：参考 部署 Web 服务

5️⃣ 卸载服务

sudo PasswordReset -service-uninstall

卸载时会自动清理：systemd 服务/timer 文件、二进制文件、软链接、备份文件。

完整示例

# 1. 下载并解压
wget https://download.liumou.site/PasswordReset/v2.0.1/PasswordReset-client-linux-X86_64.tar.gz
tar xzf PasswordReset-client-linux-X86_64.tar.gz

# 2. 添加用户（交互输入安全密钥）
sudo ./PasswordReset_linux-X86_64 -add-user=admin -add

# 3. 安装服务（自动部署二进制+创建命令软链接）
sudo ./PasswordReset_linux-X86_64 -service-install -hour=12

# 4. 安装后直接使用 PasswordReset 命令
sudo PasswordReset -list-users
sudo PasswordReset -add-user=backup -add

# 5. 查询密码（Web 服务）
# https://encrypt.liumou.site/

# 6. 卸载服务
sudo PasswordReset -service-uninstall