simpleserver-tool 0.3.0
dotnet tool install --global simpleserver-tool --version 0.3.0
dotnet new tool-manifest # if you are setting up this repo dotnet tool install --local simpleserver-tool --version 0.3.0
#tool dotnet:?package=simpleserver-tool&version=0.3.0
nuke :add-package simpleserver-tool --version 0.3.0
SimpleServer
一个用于运行静态后端的简单服务器命令行工具。用 C# 编写,跨平台。
它是跨平台的,大小约为 30MB,运行时不需要 .NET 或 .NET Framework。
运行
将版本下载到您的操作系统(见下文)并按照以下方式运行:
simpleserver [<path>] [options]
如果您不带参数运行它,它将服务当前运行的目录(pwd/cwd),绑定到所有网络接口(0.0.0.0
)在端口 8080
上,而不记录到 stdout。这些都是可配置的,还有很多其他选项。
选项 | 类型 | 默认值 | 描述 |
---|---|---|---|
-i , --index |
开关 | 当找不到文件时使用默认索引文件。 | |
--interface <interface> |
字符串 | 0.0.0.0 |
要绑定服务器的网络接口(IP 或主机名)。 |
-p, --port <port> |
u16 | 8080 |
运行服务器的端口。 |
--index-name <index-name> |
字符串 | index.html |
默认索引文件名。 |
-v , --verbose |
开关 | 显示详细输出。 | |
-s , --simple-paths |
开关 | 使用简单路径。允许将 'file.html' 服作为 '/file'。 | |
-l , --log-http |
开关 | 将 http 输出记录到 stdout。 | |
-d , --directory-browsing |
开关 | 启用目录浏览。 |
您可以通过在命令行中键入 simpleserver --help
来查看这些选项。
例如,要运行一个 SPA,您将需要服务每个静态文件,并为每个未匹配到文件的请求路由服务 index.html
。如下所示
simpleserver -i
要更改文件,您还必须提供另一个选项
simpleserver -i --index-name default.html
不兼容的选项
您不能同时运行目录浏览和索引文件。如果您尝试这样做,目录浏览将被禁用。
您不能同时运行简单路径和目录浏览。如果您尝试这样做,简单路径将被禁用。
运行框架相关的 .dll
框架相关的 simpleserver.dll 可以在您已经安装 .NET 运行时的地方运行。您需要 .NET 6 运行时,并按以下方式运行它
dotnet simpleserver.dll [<path>] [options]
您需要所有在 .tgz 中的文件,将它解压缩到目录中,并从那里运行。
安装
独立编译版本
从最新版本中下载一个构件[链接]并将其添加到您的路径中。
有Windows和Linux(x86、ARM和Musl)的构件。Linux版本是动态编译版本,不能在无分布容器(FROM scratch
)上运行。
simpleserver-linux-arm
- Linux ARMsimpleserver-linux-musl-x64
- Linux x64 Musl(Alpine等)simpleserver-linux-x64
- Linux x64simpleserver.exe
- Windows x64simpleserver.tgz
- 跨平台,依赖框架
.pdb
文件是符号文件,仅用于调试,不用于运行程序。
作为 dotnet 命令行工具
如果您已安装 .NET 开发工具包,则可以将此工具作为 dotnet 全局工具安装。该工具有 [链接]托管在 nuget.org 上的 simpleserver-tool
仓库中。使用以下命令安装:
dotnet tool install --global simpleserver-tool
自动补全
这是使用 dotnet-suggest
编写的。您需要一个 .NET 开发工具包来启用自动补全。详细步骤可在 [链接] 中找到。
它在 .NET 开发工具包支持的任何地方都能工作。支持的壳通常在上文文档中详细说明,包括 Bash、Zsh 和 PowerShell。
贡献
欢迎提问、评论、错误报告和拉取请求。可在 GitHub 上的该项目提交。
包含重现步骤(包括代码)的错误报告是最好的。更好的是,将其作为一个拉取请求的形式提交。
作者
许可证
在 MIT 许可证下授权。
产品 | 版本 兼容和额外的计算目标框架版本。 |
---|---|
.NET | net6.0 兼容。 net6.0-android 已计算。 net6.0-ios 已计算。 net6.0-maccatalyst 已计算。 net6.0-macos 已计算。 net6.0-tvos 已计算。 net6.0-windows 已计算。 net7.0 已计算。 net7.0-android 已计算。 net7.0-ios 已计算。 net7.0-maccatalyst 已计算。 net7.0-macos 已计算。 net7.0-tvos 已计算。 net7.0-windows 已计算。 net8.0 已计算。 net8.0-android 已计算。 net8.0-browser 已计算。 net8.0-ios 已计算。 net8.0-maccatalyst 已计算。 net8.0-macos 已计算。 net8.0-tvos 已计算。 net8.0-windows 已计算。 |
此包没有依赖。