# 🛡️ 乌萨奇的白名单公益IP访问权限控制V2介绍文档

大家好！我是乌萨奇！
今天给大家好好说一下这个东西怎么玩！
它能帮你简单快速地管理哪些 IP 可以访问你的服务。

[V2官网 https://ipsafev2.537233.xyz/](https://ipsafev2.537233.xyz/)
---

## 🌟 这是什么？

这是一个基于 **HTTP 接口** 的 IP 白名单系统。
- 每个用户都有自己独立的 **文件夹 + token**
- 操作需要带 token，安全又简单
- 支持 **增删 IP、查日志、刷新 token、SSH 白名单脚本**

一句话总结：**它帮你用最轻的方式管理“谁能进 / 谁被挡”。**

---

## 🔧 功能一览

| 功能 | 接口 / 命令 | 说明 |
|------|-------------|------|
| 创建专属文件夹 & token | `/mkdir` | 系统分配随机文件夹 + token |
| 添加 IP | `/你的路径/add?token=yourtoken` | 提交当前你的ip IP + token |
| 添加 IP | `/你的路径/add?ip=yourip&token=yourtoken` | 提交指定IP + token |
| 删除 IP | `/你的路径/del?token=yourtoken` | 删除当前访问IP + token|
| 删除 IP | `/你的路径/del?ip=yourip&token=yourtoken` | 删除指定IP + token|
| 查看白名单 | `/你的路径/iplist?token=yourtoken` | 列出所有已加入的 IP |
| 查看日志 | `/你的路径/log?token=yourtoken` | 查访问记录（UTC 时间） |
| 删掉整个文件夹 | `/delete?path=你的路径&token=你的token` | 清空你的个人文件夹里所有数据 |
| 刷新 token | `/changetoken?path=你的路径&token=你的token&new_token=新的token` | 换一个新 token |
| SSH 白名单脚本 | `/sshwhitelist.sh` | 自动管理 SSH 连接的白名单 |

## 🔑 关于 token

在整个系统中，**token 就是你的访问凭证**，相当于一把钥匙。
- **生成方式**：当你用 `/mkdir` 创建专属文件夹时，系统会同时生成一个随机 token。
- **作用**：所有操作（添加 / 删除 IP、查看日志、刷新白名单等）都必须带上 token，系统才会执行。
- **身份类比**：可以理解为 **path 是用户名，token 是密码**，缺一不可。
- **安全建议**：
- 妥善保管 token，不要泄露
- 如果怀疑 token 泄露，可以用 `/changetoken` 立即刷新生成新的
- token 更新后，旧的 token 将立即失效

> ⚠️ 一句话总结：
> **没有 token，你啥也改不了；token 泄露，别人就能替你改。**

> ⚠️ 注意：
> - `path` 是你的路径，`token` 是钥匙，请妥善保管
> - 可以理解为 **path 是用户名，token 是密码**
> - SSH 脚本默认端口为 233，记得自己改或者测试哈
> - 系统日志为 UTC，SSH 日志为 Asia/Shanghai 时区

---

## 🚀 最近更新亮点

1. **接口更统一** —— 所有操作都能用 HTTP GET 完成
2. **SSH 脚本支持** —— 白名单直接作用到 SSH 连接
3. **可刷新 token** —— 避免泄露风险
4. **日志功能完善** —— 谁什么时候访问过一清二楚

---

## 🎯 适合人群 / 使用场景

- 想控制 **VPS / 服务器访问** 的个人或小团队
- 希望 SSH 登录来源更安全可控
- 不想折腾繁琐的防火墙规则
- 想要一个轻量级、自动化接口式的 IP 管理工具
- **不仅限于 SSH**：你还可以自己搭配，用它做一个 **IP 白名单转发系统**，
比如结合 Cloudflare 或者其他服务，进一步提升访问控制能力。

---

👉 详细说明与使用方法请看文档：
[https://ipsafev2.537233.xyz/information.html](https://ipsafev2.537233.xyz/information.html)

---