手动下载可执行文件部署运行的方法

手动部署最直接：下载二进制、解压、运行，全程自己掌控目录和版本。

拿到程序

到官方发布页（Release）下载与系统架构对应的压缩包；最新版前端已与后端打包在一起，解压即用，不需要再单独下前端文件。旧机器报 GLIBC 版本错误时改下 musl 版本，见安装问题。

各平台运行命令

Linux

tar -zxvf alist-xxxx.tar.gz
chmod +x alist
./alist server

macOS

tar -zxvf alist-xxxx.tar.gz
chmod +x alist
./alist server

Windows（解压后在该目录开 PowerShell）

.\alist.exe server

Windows（scoop 包管理器）

scoop install alist
alist server

看到 start server@0.0.0.0:5244 且无报错，就是启动成功；首次运行会输出初始密码。浏览器打开「机器 IP 加 5244 端口」进入登录页。

注册成常驻服务（守护进程）

• Linux：写一个 systemd 服务单元，ExecStart 指向程序所在路径加 server 参数，然后 daemon-reload，即可用 systemctl 管理。
• macOS：写 LaunchAgents 的 plist 配置后 launchctl load。
• Windows：官方推荐两种——用 NSSM 把 exe 注册成系统服务（可指定日志文件路径）；或写两个 VBS 脚本，一个隐藏窗口启动、一个 taskkill 停止，双击即用。

v3.4.0 起还有自带的静默管理命令：alist start、alist stop、alist restart。

下一步

拿到初始密码后进后台挂存储：添加存储。