zishuo/Spark
1
0
Fork 0
mirror of https://github.com/XZB-1248/Spark synced 2025-09-26 20:21:11 +08:00
Code Issues Packages Projects Releases Wiki Activity

Refactor README.ZH.md

Browse Source
This commit is contained in:
XZB-1248
2025-02-06 01:05:17 +08:00
committed by GitHub
parent d962aca68e
commit 79535b7118
1 changed files with 44 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files

103
README.ZH.md
View File

@@ -2,17 +2,19 @@
---
<h1 >Spark</h1>
<h1>Spark</h1>
**Spark** 是一个免费、安全、开源、基于网页、跨平台且功能丰富的远程管理工具，可以让你通过浏览器，随时随地管理设备。
本项目**不**收集你的任何信息，无论是服务端或是客户端。因此，服务端永远不会自动更新，客户端永远只会与服务端通信。
✅ **不收集数据**: Spark不会收集任何用户数据。
✅ **不自动更新**: 服务端不会在任何情况下进行自动更新。
✅ **直接通信**: 客户端永远只会和你的服务器通信，隐私优先。
---
| ![GitHub repo size](https://img.shields.io/github/repo-size/DGP-Studio/Snap.Genshin?style=flat-square) | ![GitHub issues](https://img.shields.io/github/issues/XZB-1248/Spark?style=flat-square) | ![GitHub closed issues](https://img.shields.io/github/issues-closed/XZB-1248/Spark?style=flat-square) |
| ![GitHub repo size](https://img.shields.io/github/repo-size/XZB-1248/Spark?style=flat-square) | ![GitHub issues](https://img.shields.io/github/issues/XZB-1248/Spark?style=flat-square) | ![GitHub closed issues](https://img.shields.io/github/issues-closed/XZB-1248/Spark?style=flat-square) |
|--------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|
| [![GitHub downloads](https://img.shields.io/github/downloads/XZB-1248/Spark/total?style=flat-square)](https://github.com/XZB-1248/Spark/releases) | [![GitHub release (latest by date)](https://img.shields.io/github/downloads/XZB-1248/Spark/latest/total?style=flat-square)](https://github.com/XZB-1248/Spark/releases/latest) |
@@ -20,34 +22,31 @@
---
## 免责声明
## ⚠️ 免责声明
**本项目及其源代码和发行版，旨在用于学习和交流。**
<br />
**禁止用于任何非法用途！**
<br />
**使用本项目所带来的风险由使用者本人承担。**
<br />
**作者和开发者不会对你错误使用而造成的损害承担任何责任。**
**数据无价，在点击任何按钮、输入任何命令之前，请三思。**
❌ **禁止用于任何非法用途！**
❌ **使用本项目所带来的风险由使用者本人承担。**
✅ **作者和开发者不会对你错误使用而造成的损害承担任何责任。**
如果你发现了任何安全问题，请**不要**发布issue，并立即[**联系我**](mailto:i@1248.ink)。
如果你发现了任何安全问题，请**不要**发布issue，并立即[联系我](mailto:i@1248.ink)。
---
## 快速开始
## 🚀 快速开始
### 本地安装
### 二进制运行
* [下载服务端](https://github.com/XZB-1248/Spark/releases)，按照[配置文件说明](#配置文件)，设置好配置文件。
* 运行服务端，访问`IP:端口`，例如 `http://localhost:8000/` 。
* 在管理页面中生成客户端，并部署到设备上。
* 现在就可以控制这个设备了。
1. 在[releases](https://github.com/XZB-1248/Spark/releases)中下载二进制文件。
2. 按照[配置文件说明](#配置文件)，设置好配置文件。
3. 运行服务端，访问`IP:端口`，例如 `http://localhost:8000/` 。
4. 在管理页面中生成客户端，并部署到目标设备上。
5. 开始控制目标设备。
---
## 配置文件
## ⚙️ 配置文件
在服务端的根目录下，创建`config.json`文件，按照以下格式填写：
@@ -66,21 +65,19 @@
}
```
* `listen` `必填`，格式为 `IP:端口`
* `salt` `必填`，修改后需要重新部署客户端，长度不大于24
* `auth` `选填`，格式为 `用户名:密码`
* 密码强烈建议使用hash加密
* 格式为`$算法$密文`，例如`$sha256$11223344556677AABBCCDDEEFF`
* 支持的算法有：`sha256`，`sha512`和`bcrypt`
* 如果不按照格式填写，将会被视为明文密码
* `log` `选填`，日志配置
* `level` `选填`，可选值：`disable`, `fatal`, `error`, `warn`, `info`, `debug`
* `path` `选填`，默认为`./logs`
* `days` `选填`，默认为`7`
- **`listen`**（必填），格式为 `IP:端口`
- **`salt`**（必填），长度不大于**24**的随机字符串，修改后需要**重新部署所有客户端**
- **`auth`**（选填），格式为 `用户名:密码`
- 密码强烈建议使用hash加密（格式为`$算法$密文`，例如`$sha256$11223344556677AABBCCDDEEFF`）
- 支持的算法有：`sha256`，`sha512`和`bcrypt`
- **`log`**（选填），日志配置
- `level`日志等级，可选值：`disable`, `fatal`, `error`, `warn`, `info`, `debug`
- `path`日志保存目录（默认为`./logs`）
- `days`日志保存天数（默认为`7`）
---
## 特性
## 🛠️ 特性
| 特性/OS | Windows | Linux | MacOS |
|-------|---------|-------|-------|
@@ -103,12 +100,11 @@
| * 休眠 | ✔ | ❌ | ❌ |
| * 锁屏 | ✔ | ❌ | ❌ |
* 空单元格代表目前暂未测试。
* 星号代表该功能可能需要管理员或root权限才能使用。
🚨 **星号代表该功能可能需要管理员或root权限才能使用。**
---
## 截图
## 📸 截图
![overview](./docs/overview.ZH.png)
@@ -126,62 +122,49 @@
---
## 开发
## 🔧 开发
### 注意
本项目由三个部分组成，你必须把它们都编译一下。
如果你不想陷入无止尽的安装、配置的过程，建议去 [快速开始](#快速开始) 。
* 客户端
* 服务端
* 前端页面
### 组件
本项目由三个部分组成：
- **客户端**
- **服务端**
- **前端**
如果要让客户端支持除了Linux和Windows之外的系统，你必须要安装对应的C交叉编译工具链。
例如，如果要给Android系统编译客户端，那就必须安装 [Android NDK](https://developer.android.com/ndk/downloads) 。
### 指南
```bash
# Clone该项目。
# Clone项目
$ git clone https://github.com/XZB-1248/Spark
$ cd ./Spark
# 开始编译前端页面。
# 编译前端
$ cd ./web
# 安装所有的依赖，然后编译。
$ npm install
$ npm run build-prod
# 通过statik，将前端文件嵌入到服务端里。
# 服务端嵌入静态资源
$ cd ..
$ go install github.com/rakyll/statik
$ statik -m -src="./web/dist" -f -dest="./server/embed" -p web -ns web
# 开始编译客户端。
# 在使用类Unix系统时，运行以下命令。
# 编译客户端
$ mkdir ./built
$ go mod tidy
$ go mod download
$ ./scripts/build.client.sh
# 最终开始编译服务端。
# 编译服务端
$ mkdir ./releases
$ ./scripts/build.server.sh
```
另外新建一个目录，将`releases`目录中对应的服务端版本复制进去。
<br />
回到项目目录，把整个`built`目录复制到新建的目录中。
<br />
最后，把开头提到的配置文件也复制进去，即可运行服务端。
---
## 功能定制
@@ -231,7 +214,7 @@ Spark使用了许多第三方的开源项目。
### 感谢
* [natpass](https://github.com/lwch/natpass) (MIT License)
* 图像差异算法部分参考了natpass项目的有关逻辑。
* 图像差异部分参考了natpass项目的有关逻辑。
---
@@ -240,6 +223,6 @@ Spark使用了许多第三方的开源项目。
[![Stargazers over time](https://starchart.cc/XZB-1248/Spark.svg)](https://starchart.cc/XZB-1248/Spark)
---
## 开源协议
## 📜 开源协议
本项目基于 [BSD-2 协议](./LICENSE) 。