Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zu1k/srun

srun 深澜认证登录，超轻量、多平台，支持多拨、自动探测IP、指定网卡
https://github.com/zu1k/srun

cli rust srun srun-client srun3000 srun3k srun4k

Last synced: 14 days ago
JSON representation

srun 深澜认证登录，超轻量、多平台，支持多拨、自动探测IP、指定网卡

Host: GitHub
URL: https://github.com/zu1k/srun
Owner: zu1k
License: gpl-3.0
Created: 2021-11-02T13:52:39.000Z (about 3 years ago)
Default Branch: master
Last Pushed: 2024-09-02T06:57:16.000Z (2 months ago)
Last Synced: 2024-10-15T15:10:58.436Z (28 days ago)
Topics: cli, rust, srun, srun-client, srun3000, srun3k, srun4k
Language: Rust
Homepage:
Size: 188 KB
Stars: 229
Watchers: 2
Forks: 29
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# srun

[![GitHub stars](https://img.shields.io/github/stars/zu1k/srun)](https://github.com/zu1k/srun/stargazers)
[![GitHub forks](https://img.shields.io/github/forks/zu1k/srun)](https://github.com/zu1k/srun/network)
[![GitHub issues](https://img.shields.io/github/issues/zu1k/srun)](https://github.com/zu1k/srun/issues)
[![Release](https://img.shields.io/github/release/zu1k/srun)](https://github.com/zu1k/srun/releases)
[![Build](https://github.com/zu1k/srun/actions/workflows/build-test.yml/badge.svg)](https://github.com/zu1k/srun/actions/workflows/build-test.yml)
[![GitHub license](https://img.shields.io/github/license/zu1k/srun)](https://github.com/zu1k/srun/blob/master/LICENSE)

Srun authentication system login tools. [compatible versions](https://github.com/zu1k/srun/discussions/8)

## Features

- Support both command line and config file
- Multiple IP acquisition methods
- User Specified
- Auto detect
- User select
- Query by NIC name
- Support strict bind
- Support multiple users login, suitable for multi-dial
- Support multi CPU architecture
- Support multi system

## Usage

[Pre-built binaries](https://github.com/zu1k/srun/releases)

### CMD mode

```
./srun login -u USERNAME -p PASSWORD -i IP [-s AUTH_SERVER]
```

`AUTH_SERVER` should contain protocols, e.g. `http://10.0.0.1`.

#### Which IP to be authorized?

srun support three methods of specifying IP:

- use `-i IP` to specify ip
- use `-d` to auto detect ip
- use `--select-ip` to select ip

##### specify IP

You need to check the IP address of each network interfaces in advance and choose the correct IP to be authorized.

##### detect IP

srun support automatic IP detection, it determines the IP address from the information returned by the authentication server.

This is useful in cases where you only have one IP address to authorize.

If you are multidialing and have multiple legitimate IPs at the same time, you need to authorize multiple IPs at the same time, this method will not authorize all IPs properly.

##### select IP

This method is similar to the first method, except that it saves you the trouble of manually querying all the IPs.

srun will query all the legitimate IPs in advance and then print a list of IPs for you to choose from.

```sh
$ ./srun login -u USERNAME -p PASSWORD --select-ip
Please select your IP:
1. 192.168.226.5
2. 10.27.196.218
3. 172.16.150.1
4. 192.168.128.1
5. 198.10.0.1
2
you choose 10.27.196.218
...
```

Please note that when your computer has only one IP that can be authorized, we will simply omit the selection process and use this IP.

### Using a Config

Usually, it is sufficient to specify the information directly using command line parameters.

In order to meet the needs of multi-dial users, srun support reading multiple user information from a config file.

```
./srun login -c config.json
```

config file template

```json
{
"server": "http://10.0.0.1",
"strict_bind": false,
"double_stack": false,
"retry_delay": 1000,
"retry_times": 3,
"n": 200,
"type": 1,
"acid": 12,
"os": "Windows",
"name": "Windows 98",
"users": [
{
"username": "username1",
"password": "password1",
"ip": "10.1.2.3"
},
{
"username": "username2@cmcc",
"password": "password2",
"if_name": "macvlan1"
}
]
}
```

As you can see, we support `ip` or `if_name`.

If your IP will not change, you can use `ip` to specify directly.

But for multi-dial, IP may be automatically assigned by DHCP and may change, at this time we suggest to use `if_name` to specify the corresponding NIC name, we will automatically query the IP under that NIC as the IP to be authorized.

On windows, the NIC name should be like `{93123211-9629-4E04-82F0-EA2E4F221468}`, use `--select-ip` to see.

### Operator selection

Some colleges support network operator selection, which implemented by append the operator code to the username.

Operator code:

- 中国电信: [`chinanet`, `ctcc`]
- 中国移动: [`cmcc`]
- 中国联通: [`unicom`, `cucc`]
- 校园网: [`xn`]

For example, if you choose `cmcc`, just append `@cmcc` to your username, like `202112345@cmcc`.

This code needs to be confirmed by capturing packets.

### TLS support

To keep the binary as small as possible, the pre-compiled binary remove the non-essential `tls` support

If your authentication system uses `https`, You need to compile it yourself with feature `tls` enabled.

```sh
cargo build --features "tls" --release
```

## License