安装指南
选择适合您的安装方式快速部署 Shortlinker。
环境要求
运行环境
- 操作系统：Linux、macOS、Windows
- 网络连接：用于下载依赖
源码编译环境
- Rust: >= 1.85.0 (必需，Edition 2024)
- Git: 用于克隆项目
安装方式
🐳 Docker 部署（推荐）
无需任何依赖，一条命令启动：
bash
# 基础运行
docker run -d -p 8080:8080 e1saps/shortlinker
# 数据持久化（推荐）
docker run -d -p 8080:8080 -v $(pwd)/data:/data e1saps/shortlinker📦 预编译二进制
下载对应平台的预编译版本：
bash
# Linux x64
wget https://github.com/AptS-1547/shortlinker/releases/latest/download/shortlinker-linux-x64.tar.gz
tar -xzf shortlinker-linux-x64.tar.gz
./shortlinker
# macOS
wget https://github.com/AptS-1547/shortlinker/releases/latest/download/shortlinker-macos.tar.gz
# Windows
# 下载 shortlinker-windows.zip 并解压🔧 源码编译
适合需要定制的用户：
bash
# 1. 安装 Rust (如果没有)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source ~/.cargo/env
# 2. 检查版本
rustc --version # 应该 >= 1.85.0
# 3. 克隆并编译
git clone https://github.com/AptS-1547/shortlinker.git
cd shortlinker
# 基础编译（仅服务器功能）
cargo build --release
# 包含 TUI 界面编译
cargo build --release --features tui
# 全功能编译（服务器 + CLI + TUI）
cargo build --release --features full
# 4. 运行
./target/release/shortlinker快速验证
安装完成后，验证服务是否正常：
bash
# 启动服务
./shortlinker
# 另开终端测试
curl -I http://localhost:8080/
# 应该返回 307 重定向常见问题
Rust 版本过低
bash
# 更新到最新版本
rustup update编译失败
bash
# 清理后重新编译
cargo clean && cargo build --release端口被占用
bash
# 使用其他端口
SERVER_PORT=3000 ./shortlinker下一步
安装完成后，继续阅读：