基于 RUST 的 WEB 资源服务器
Github 地址
LTPP-GIT 地址
官方文档
该项目于 2024 年 5 月 1 日开始开发
预期功能
功能 | 支持情况 | 当前情况 |
---|---|---|
多线程支持 | 是 | 是 |
服务支持配置化 | 是 | 是 |
防盗链支持 | 是 | 是 |
gzip 支持 | 是 | 是 |
反向代理支持 | 是 | 是 |
自定义状态码对应资源文件 | 是 | 是 |
日志支持 | 是 | 是 |
负载均衡支持 | 是 | 是 |
域名绑定解析支持 | 是 | 是 |
资源解析 | 是 | 是 |
history 模式支持 | 是 | 是 |
自定义响应头 | 是 | 是 |
目前进度
- 自定义响应头
- 多线程支持
- 配置化
- 日志输出
- 资源解析
- history 模式支持
- 域名绑定支持
- 一个端口对应多域名支持
- 反向代理支持
- 负载均衡支持
- 防盗链支持
- gzip 支持
错误页
- 在
root_path
下名称为对应状态码.html
,例如404
对应页面404.html
JSON 示例
首次运行会自动生成
config.json
配置文件,填写好后重新运行即可
以上配置将当前目录作为访问地址的根目录,
监听了80
和81
端口,绑定IP
和域名
为127.0.0.1
和localhost
用来处理请求,
当访问为空则重写路径到当前目录的index.html
(适用于Vue
等打包后的资源),
日志保存在当前目录logs
下
配置中的
listen_ip
为服务端IP
,bind_server_name
下的key
为域名或者IP
, 一般listen_ip
为127.0.0.1
,
如果bind_server_name
配置了localhost
域名,那么可以使用localhost
访问,
但是不支持127.0.0.1
,如需支持127.0.0.1
,在bind_server_name
中添加即可
如果本地做了映射,需要同时添加映射的域名和127.0.0.1
反向代理
- 系统会检测
proxy
数组里每个元素是否是合法URL
,如果是合法URL
那么系统会加入到反向代理的列表,如果最终反向代理列表为空则会加载静态资源 - 反向代理会映射请求路径和请求参数,如果配置文件
proxy
中的元素加了路径,系统会忽略 - 反向代理时,会随机从反向代理列表中获取一个代理地址
PROXY_URL
,系统会截取PROXY_URL
字段除了path
部分的url
,实际path
来自请求时的path
,参数会进行拼接,如果PROXY_URL
参数和请求参数冲突,请求参数会追加在PROXY_URL
参数后面
负载均衡
- 反向代理时,会随机从反向代理列表中获取一个代理地址
PROXY_URL
GZIP
- 请求头
Accept-Encoding
需要包含gzip
并且响应头Content-Encoding
需要包含gzip
- 配置
gzip_level
用于设置压缩率,范围从1 - 9
,越大压缩的越小,耗时也会更久,建议 4/5 即可
异常
- 如果出现页面/请求加载异常的情况,需要增加
buffer_size
数值
防盗链
hotlink_protection
使用正则进行匹配(系统内部会额外处理…/防盗链情况)
运行效果
配置文件示例
{
"server": [
{
"listen_ip": "0.0.0.0",
"listen_port": 80,
"bind_server_name": {
"127.0.0.1": {
"root_path": "./",
"buffer_size": 10240,
"gzip_level": 1,
"log_dir_path": "./logs",
"empty_path_try_files_path": "./index.html",
"response_header_list": [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: text/html",
"Content-Encoding: gzip"
],
"proxy": [],
"proxy_timeout_seconds": 10,
"hotlink_protection": []
},
"localhost": {
"root_path": "./",
"buffer_size": 10240,
"gzip_level": 1,
"log_dir_path": "./logs",
"empty_path_try_files_path": "./index.html",
"response_header_list": [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: application/json",
"Content-Encoding: gzip"
],
"proxy": [
"https://api.ltpp.vip",
"https://api.ltpp.vip/Version/getVersion",
"https://api.ltpp.vip/Version/getVersion?origin=proxy1"
],
"proxy_timeout_seconds": 10,
"hotlink_protection": []
}
}
},
{
"listen_ip": "0.0.0.0",
"listen_port": 81,
"bind_server_name": {
"127.0.0.1": {
"root_path": "./",
"buffer_size": 10240,
"gzip_level": 1,
"log_dir_path": "./logs",
"empty_path_try_files_path": "./index.html",
"response_header_list": [
"Access-Control-Allow-Origin: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Credentials: true",
"Server: RUST-WEB-SERVER",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: application/json",
"Content-Encoding: gzip"
],
"proxy": ["https://api.ltpp.vip/Version/getVersion?origin=proxy1"],
"proxy_timeout_seconds": 10,
"hotlink_protection": ["origin=1$"]
}
}
}
]
}
运行效果
日志
支持配置,日期和完整请求记录
[2024-05-28 23:40:07]
Binding => 127.0.0.1:80
Server {
root_path: "./",
buffer_size: 10240,
gzip_level: 1,
log_dir_path: "./logs",
empty_path_try_files_path: "./index.html",
response_header_list: [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: text/html",
"Content-Encoding: gzip",
],
proxy: [],
proxy_timeout_seconds: 10,
hotlink_protection: [],
}
Binding => localhost:80
Server {
root_path: "./",
buffer_size: 10240,
gzip_level: 1,
log_dir_path: "./logs",
empty_path_try_files_path: "./index.html",
response_header_list: [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: application/json",
"Content-Encoding: gzip",
],
proxy: [
"https://api.ltpp.vip",
"https://api.ltpp.vip/Version/getVersion",
"https://api.ltpp.vip/Version/getVersion?origin=proxy1",
],
proxy_timeout_seconds: 10,
hotlink_protection: [],
}
[2024-05-28 23:40:07]
Binding => 127.0.0.1:80
Server {
root_path: "./",
buffer_size: 10240,
gzip_level: 1,
log_dir_path: "./logs",
empty_path_try_files_path: "./index.html",
response_header_list: [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: text/html",
"Content-Encoding: gzip",
],
proxy: [],
proxy_timeout_seconds: 10,
hotlink_protection: [],
}
Binding => localhost:80
Server {
root_path: "./",
buffer_size: 10240,
gzip_level: 1,
log_dir_path: "./logs",
empty_path_try_files_path: "./index.html",
response_header_list: [
"Server: RUST-WEB-SERVER",
"Access-Control-Allow-Credentials: true",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Origin: *",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: application/json",
"Content-Encoding: gzip",
],
proxy: [
"https://api.ltpp.vip",
"https://api.ltpp.vip/Version/getVersion",
"https://api.ltpp.vip/Version/getVersion?origin=proxy1",
],
proxy_timeout_seconds: 10,
hotlink_protection: [],
}
[2024-05-28 23:40:07]
Binding => 127.0.0.1:81
Server {
root_path: "./",
buffer_size: 10240,
gzip_level: 1,
log_dir_path: "./logs",
empty_path_try_files_path: "./index.html",
response_header_list: [
"Access-Control-Allow-Origin: *",
"Access-Control-Allow-Methods: *",
"Access-Control-Allow-Headers: *",
"Access-Control-Allow-Credentials: true",
"Server: RUST-WEB-SERVER",
"Git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git",
"Content-Type: application/json",
"Content-Encoding: gzip",
],
proxy: [
"https://api.ltpp.vip/Version/getVersion?origin=proxy1",
],
proxy_timeout_seconds: 10,
hotlink_protection: [
"origin=1$",
],
}
[2024-05-28 23:40:07]
Listening => 0.0.0.0:80
[2024-05-28 23:40:07]
Binding => 127.0.0.1:80
[2024-05-28 23:40:07]
Binding => localhost:80
[2024-05-28 23:40:07]
Binding => 127.0.0.1:80
[2024-05-28 23:40:07]
Listening => 0.0.0.0:81
[2024-05-28 23:40:07]
Binding => 127.0.0.1:81
[2024-05-28 23:40:07]
Binding => localhost:81
[2024-05-28 23:40:07]
Binding => 127.0.0.1:81
[2024-05-28 23:40:10]
HttpRequest {
path: "/_static/out/browser/serviceWorker.js",
method: "GET",
query: [],
headers: {
"accept-language": "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
"accept": "*/*",
"service-worker": "script",
"sec-fetch-dest": "serviceworker",
"sec-fetch-mode": "same-origin",
"referer": "http://127.0.0.1/_static/out/browser/serviceWorker.js",
"accept-encoding": "gzip, deflate, br, zstd",
"cache-control": "max-age=0",
"host": "127.0.0.1",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
"cookie": "SameSite=Lax; Hm_lvt_9793f42b498361373512340937deb2a0=1689155374; _ga=GA1.1.39230079.1707025003; _ga_69MPZE94D5=GS1.1.1707025002.1.1.1707026740.0.0.0; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=5RJrrwsVlvqY7uteEWcRoXI%2BvTKWWpA23SKZpX9BCDRw8Q17ueAcTXRd8Po%3D",
"sec-fetch-site": "same-origin",
"connection": "keep-alive",
},
body: {
"sec-fetch-site": [
"same-origin",
],
"accept-encoding": [
"gzip, deflate, br, zstd",
],
"accept": [
"*/*",
],
"user-agent": [
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
],
"connection": [
"keep-alive",
],
"cache-control": [
"max-age=0",
],
"cookie": [
"SameSite=Lax; Hm_lvt_9793f42b498361373512340937deb2a0=1689155374; _ga=GA1.1.39230079.1707025003; _ga_69MPZE94D5=GS1.1.1707025002.1.1.1707026740.0.0.0; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=5RJrrwsVlvqY7uteEWcRoXI%2BvTKWWpA23SKZpX9BCDRw8Q17ueAcTXRd8Po%3D",
],
"accept-language": [
"zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
],
"sec-fetch-mode": [
"same-origin",
],
"host": [
"127.0.0.1",
],
"referer": [
"http://127.0.0.1/_static/out/browser/serviceWorker.js",
],
"sec-fetch-dest": [
"serviceworker",
],
"service-worker": [
"script",
],
},
}
[2024-05-28 23:40:10]
Resource load fail => ./_static/out/browser/serviceWorker.js
[2024-05-28 23:40:21]
HttpRequest {
path: "/Version/getVersion",
method: "GET",
query: [
(
"origin",
"proxy1",
),
],
headers: {
"sec-ch-ua-mobile": "?0",
"connection": "keep-alive",
"sec-ch-ua": "\"Microsoft Edge\";v=\"125\", \"Chromium\";v=\"125\", \"Not.A/Brand\";v=\"24\"",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
"sec-fetch-site": "none",
"sec-fetch-user": "?1",
"accept-language": "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
"sec-fetch-dest": "document",
"host": "127.0.0.1:81",
"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
"accept-encoding": "gzip, deflate, br, zstd",
"upgrade-insecure-requests": "1",
"sec-fetch-mode": "navigate",
"cookie": "SameSite=Lax; Hm_lvt_9793f42b498361373512340937deb2a0=1689155374; _ga=GA1.1.39230079.1707025003; _ga_69MPZE94D5=GS1.1.1707025002.1.1.1707026740.0.0.0; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=5RJrrwsVlvqY7uteEWcRoXI%2BvTKWWpA23SKZpX9BCDRw8Q17ueAcTXRd8Po%3D",
"sec-ch-ua-platform": "\"Windows\"",
},
body: {
"sec-fetch-user": [
"?1",
],
"accept-language": [
"zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
],
"sec-fetch-site": [
"none",
],
"accept": [
"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
],
"sec-ch-ua-platform": [
"\"Windows\"",
],
"accept-encoding": [
"gzip, deflate, br, zstd",
],
"host": [
"127.0.0.1:81",
],
"sec-fetch-mode": [
"navigate",
],
"upgrade-insecure-requests": [
"1",
],
"sec-fetch-dest": [
"document",
],
"sec-ch-ua-mobile": [
"?0",
],
"cookie": [
"SameSite=Lax; Hm_lvt_9793f42b498361373512340937deb2a0=1689155374; _ga=GA1.1.39230079.1707025003; _ga_69MPZE94D5=GS1.1.1707025002.1.1.1707026740.0.0.0; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=5RJrrwsVlvqY7uteEWcRoXI%2BvTKWWpA23SKZpX9BCDRw8Q17ueAcTXRd8Po%3D",
],
"sec-ch-ua": [
"\"Microsoft Edge\";v=\"125\", \"Chromium\";v=\"125\", \"Not.A/Brand\";v=\"24\"",
],
"connection": [
"keep-alive",
],
"user-agent": [
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
],
},
}
[2024-05-28 23:40:21]
Proxy url info => https://api.ltpp.vip:443/Version/getVersion?origin=proxy1&origin=proxy1
[2024-05-28 23:40:22]
Request response info:
HTTP/1.1 200 OK
content-length: 90
access-control-allow-methods: GET, POST, PATCH
access-control-allow-headers: Authorization,Requestid,Key,Content-Type,If-Match,If-Modified-Since,If-None-Match,If-Unmodified-Since,X-CSRF-TOKEN,X-Requested-With
git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git
access-control-allow-origin: *
content-encoding: gzip
access-control-allow-credentials: true
content-type: application/json
server: nginx
connection: keep-alive
date: Tue, 28 May 2024 15:40:21 GMT
strict-transport-security: max-age=88888888
access-control-max-age: 88888888
{"code":1,"version":"2.8.0","ltpp_win_download_url":"","ltpp_mac_download_url":"","ltpp_apk_download_url":""}
[2024-05-28 23:40:24]
HttpRequest {
path: "/Version/getVersion",
method: "GET",
query: [
(
"origin",
"proxy1",
),
],
headers: {
"connection": "keep-alive",
"accept-encoding": "gzip, deflate, br, zstd",
"cache-control": "max-age=0",
"sec-fetch-mode": "navigate",
"sec-ch-ua-platform": "\"Windows\"",
"sec-fetch-site": "none",
"host": "localhost",
"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
"accept-language": "zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
"sec-ch-ua-mobile": "?0",
"sec-fetch-user": "?1",
"sec-fetch-dest": "document",
"user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
"upgrade-insecure-requests": "1",
"cookie": "SameSite=Lax; NMTID=00O6oBSFUZ8KxSqKEY4tcbYD677Qa8AAAGKxntltw; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=c3t%2FwkS4xVdqQ2GLp7IkQdf9cc4d3ClA8ae5euc5DJ4EKvgSZv6qnjCaabI%3D",
"sec-ch-ua": "\"Microsoft Edge\";v=\"125\", \"Chromium\";v=\"125\", \"Not.A/Brand\";v=\"24\"",
},
body: {
"sec-ch-ua-platform": [
"\"Windows\"",
],
"sec-ch-ua": [
"\"Microsoft Edge\";v=\"125\", \"Chromium\";v=\"125\", \"Not.A/Brand\";v=\"24\"",
],
"upgrade-insecure-requests": [
"1",
],
"user-agent": [
"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36 Edg/125.0.0.0",
],
"cookie": [
"SameSite=Lax; NMTID=00O6oBSFUZ8KxSqKEY4tcbYD677Qa8AAAGKxntltw; pma_lang=zh_CN; pma_theme=bootstrap; pmaUser-1=c3t%2FwkS4xVdqQ2GLp7IkQdf9cc4d3ClA8ae5euc5DJ4EKvgSZv6qnjCaabI%3D",
],
"accept": [
"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
],
"cache-control": [
"max-age=0",
],
"host": [
"localhost",
],
"sec-fetch-user": [
"?1",
],
"sec-fetch-dest": [
"document",
],
"accept-language": [
"zh-CN,zh;q=0.9,en;q=0.8,en-GB;q=0.7,en-US;q=0.6",
],
"connection": [
"keep-alive",
],
"sec-fetch-mode": [
"navigate",
],
"sec-ch-ua-mobile": [
"?0",
],
"accept-encoding": [
"gzip, deflate, br, zstd",
],
"sec-fetch-site": [
"none",
],
},
}
[2024-05-28 23:40:24]
Proxy url info => https://api.ltpp.vip:443/Version/getVersion?origin=proxy1
[2024-05-28 23:40:24]
Request response info:
HTTP/1.1 200 OK
content-length: 90
strict-transport-security: max-age=88888888
access-control-max-age: 88888888
access-control-allow-headers: Authorization,Requestid,Key,Content-Type,If-Match,If-Modified-Since,If-None-Match,If-Unmodified-Since,X-CSRF-TOKEN,X-Requested-With
content-type: application/json
access-control-allow-origin: *
access-control-allow-methods: GET, POST, PATCH
git: https://git.ltpp.vip/root/RUST-WEB-SERVE.git
date: Tue, 28 May 2024 15:40:23 GMT
server: nginx
connection: keep-alive
content-encoding: gzip
access-control-allow-credentials: true
{"code":1,"version":"2.8.0","ltpp_win_download_url":"","ltpp_mac_download_url":"","ltpp_apk_download_url":""}