# lzc-script

**Repository Path**: mhwy/lzc-script

## Basic Information

- **Project Name**: lzc-script
- **Description**: 懒猫脚本
- **Primary Language**: Shell
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hclient 脚本说明

用于下载并管理 `hclient-cli`，并通过本地 API 完成微服登录、两步验证等操作。脚本支持交互式菜单和命令行两种使用方式。

## 功能

- 从 Gitee 获取最新版本并下载可执行文件
- 启动 / 关闭 / 重启客户端（本地进程管理）
- 通过本地 API 登录并设置两步验证
- 设置 systemd user 级别开机启动

## 依赖

- `bash`
- `curl`
- `jq`
- `systemd`（仅“设置开机启动”功能需要）

## 快速开始

1. 赋予脚本执行权限：

   ```bash
   chmod +x hclient.sh
   ```

2. 启动脚本（进入菜单）：

   ```bash
   ./hclient.sh
   ```

也可以使用一条命令下载并启动脚本：

```bash
curl -fsSL https://gitee.com/mhwy/lzc-script/raw/master/hclient.sh -o hclient.sh && chmod +x hclient.sh && sudo ./hclient.sh
```

## 菜单说明

```bash
0 下载并启动
1 启动客户端
2 关闭客户端
3 重启客户端
4 用户登录
5 两步验证
6 设置开机启动
7 查看运行状态
q 退出
```

## 命令行方式

脚本也支持直接传参调用：

```bash
./hclient.sh download
./hclient.sh start
./hclient.sh stop
./hclient.sh restart
./hclient.sh login
./hclient.sh tfa
./hclient.sh autostart
./hclient.sh status
```

登录也可以使用 API 参数方式：

```bash
./hclient.sh add_box --boxname mybox --username myuser --password mypass
./hclient.sh add_tfa --boxname mybox --tfa 123456
```

其他 API 命令：

```bash
./hclient.sh list
./hclient.sh del_box --boxname mybox
./hclient.sh client_info
```

## 环境变量

- `DOWNLOAD_DIR`：下载目录，默认当前目录
- `PID_FILE`：进程 PID 文件路径，默认 `/tmp/hclient-cli.pid`
- `TUN_ENABLE`：是否在启动时启用 `-tun`，`1` 为启用，默认 `1`
- `SETCAP_ENABLE`：是否在启动时自动设置 capability（仅在 `TUN_ENABLE=1` 时生效），`1` 为启用，默认 `1`（需要 root）
- `LOG_FILE`：日志输出文件，默认 `/tmp/hclient-cli.out`

示例：

```bash
DOWNLOAD_DIR=/opt/hclient PID_FILE=/var/run/hclient-cli.pid ./hclient.sh
```

## 说明与注意事项

- 启动客户端使用 `nohup`，日志默认输出到 `/tmp/hclient-cli.out`。
- “设置开机启动”使用 **systemd user** 服务，需要登录用户支持 systemd user session。
- 如果本机没有 systemd，可自行实现开机自启方式（如 `rc.local` 或 crontab）。
- 在 Linux 平台推荐启用 capability 并使用 `-tun`，无需配置代理即可访问微服：

  ```bash
  sudo setcap cap_net_admin=ep ./hclient-cli-$os-$arch
  ./hclient-cli-$os-$arch -tun
  ```

- 脚本内置快捷方式（需 root）：

  ```bash
  sudo SETCAP_ENABLE=1 TUN_ENABLE=1 ./hclient.sh start
  ```