Static Web Server 下载与安装指南

Static Web Server 下载与安装指南

最新版本信息

当前最新版本为 {{RELEASE_VERSION}}，发布于 {{RELEASE_DATE}}。该版本包含多项功能改进和错误修复，建议用户及时更新。

系统兼容性

Static Web Server 支持多种操作系统和硬件架构：

• Linux：64位(x86_64)、ARM64、ARMv7、PowerPC、S390X等
• macOS：Intel(x86_64)和Apple Silicon(ARM64)芯片
• Windows：64位和32位版本
• FreeBSD/NetBSD：64位系统
• WebAssembly：可通过Wasmer运行

安装方法详解

1. 二进制安装（Linux/BSD系统）

推荐使用官方安装脚本，这是最简单快捷的安装方式：

curl --proto '=https' --tlsv1.2 -sSfL https://get.static-web-server.net | sh

安装完成后，可执行文件默认位于 /usr/local/bin 目录。

自定义安装选项

如需安装特定版本或指定安装目录，可使用环境变量：

# 设置版本和安装路径
export SWS_INSTALL_VERSION="{{RELEASE_VERSION_NUM}}"
export SWS_INSTALL_DIR="~/.local/bin"

# 执行安装
curl --proto '=https' --tlsv1.2 -sSfL https://get.static-web-server.net | sh

2. 各系统包管理器安装

Arch Linux

通过AUR助手安装：

yay -S static-web-server-bin

Exherbo Linux

添加rust仓库后安装：

cave sync
cave resolve -x repository/rust
cave resolve -x static-web-server

NixOS

使用Nix包管理器：

nix-shell -p static-web-server
# 或永久安装
nix-env -iA nixpkgs.static-web-server

macOS

通过Homebrew安装：

# 从源码构建
brew install static-web-server

# 或使用预编译二进制
brew tap static-web-server/static-web-server
brew install static-web-server-bin

Windows

使用Scoop包管理器：

scoop install static-web-server

3. WebAssembly环境

通过Wasmer运行：

wasmer run wasmer/static-web-server --net --enable-threads --mapdir /public:/my/host/dir -- --port 8787

手动下载二进制文件

x86_64架构

• macOS：static-web-server-{{RELEASE_VERSION}}-x86_64-apple-darwin.tar.gz
• Windows：提供GNU和MSVC两种工具链版本
• Linux：支持GNU libc和musl两种C库
• FreeBSD/NetBSD/Illumos：均有对应版本

ARM64架构

• Linux：支持GNU和musl两种C库
• macOS：Apple Silicon原生支持
• Android：可在ARM64设备上运行
• Windows：ARM64版本

其他架构

• ARMv7：适用于树莓派等设备
• PowerPC64le：IBM Power架构
• S390X：IBM Z系列大型机

源码安装

如需从源码构建，可下载以下文件：

• 源码压缩包：static-web-server-{{RELEASE_VERSION_NUM}}.tar.gz
• 源码ZIP包：static-web-server-{{RELEASE_VERSION_NUM}}.zip

安装验证

下载完成后，建议使用SHA256校验文件完整性：

echo "预期校验值 文件名" | sha256sum -c

注意事项

1. 安装前请确保系统满足最低要求
2. 生产环境建议使用稳定版本
3. 如遇权限问题，可尝试使用sudo或调整安装目录权限
4. Windows用户可能需要手动添加安装目录到PATH环境变量

通过以上方法安装完成后，即可使用static-web-server命令启动服务。如需配置服务参数，请参考项目文档中的配置说明部分。