以下是手动安装 Alist 并配置 Systemd 守护进程的详细步骤,适用于 Linux 系统(CentOS/Debian/Ubuntu 等):
一、手动安装 Alist
1. 下载 Alist 二进制文件
# 创建安装目录
sudo mkdir -p /opt/alist
cd /opt/alist
# 下载最新版 Alist(Linux amd64)
# 官方仓库:https://github.com/alist-org/alist/releases
sudo wget https://github.com/alist-org/alist/releases/latest/download/alist-linux-amd64.tar.gz
# 解压并赋予执行权限
sudo tar -zxvf alist-linux-amd64.tar.gz
sudo chmod +x alist
2. 初始化 Alist
# 启动一次以生成配置文件(默认端口5244)
sudo ./alist server
# 按 Ctrl+C 停止,后续用 Systemd 管理
3. 获取管理员密码
sudo ./alist admin random
# 输出示例:
# INFO username: admin
# INFO password: xxxxxx
二、配置 Systemd 守护进程
1. 创建服务文件
sudo vim /etc/systemd/system/alist.service
粘贴以下内容(注意修改路径):
[Unit]
Description=Alist Service
After=network.target
[Service]
Type=simple
WorkingDirectory=/opt/alist
ExecStart=/opt/alist/alist server
Restart=on-failure
User=root
Group=root
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
[Install]
WantedBy=multi-user.target
2. 重载并启动服务
# 重载 Systemd
sudo systemctl daemon-reload
# 启动服务
sudo systemctl start alist
# 设置开机自启
sudo systemctl enable alist
3. 检查服务状态
sudo systemctl status alist
# 正常会显示 "active (running)"
三、防火墙放行端口(可选)
如果使用防火墙,放行 Alist 默认端口 5244
:
# Firewalld(CentOS/RHEL)
sudo firewall-cmd --add-port=5244/tcp --permanent
sudo firewall-cmd --reload
# UFW(Ubuntu/Debian)
sudo ufw allow 5244/tcp
四、访问 Alist
- 浏览器访问:
http://服务器IP:5244
- 登录账号:
admin
,密码为之前生成的随机密码。
五、常见问题处理
1. 如果启动失败
查看日志:
journalctl -u alist -f
2. 修改配置文件
配置文件路径:/opt/alist/data/config.json
修改后需重启服务:
sudo systemctl restart alist
3. 更新 Alist
# 停止服务
sudo systemctl stop alist
# 重新下载并替换二进制文件
cd /opt/alist
sudo wget -O alist-linux-amd64.tar.gz https://github.com/alist-org/alist/releases/latest/download/alist-linux-amd64.tar.gz
sudo tar -zxvf alist-linux-amd64.tar.gz --overwrite
# 重启服务
sudo systemctl start alist
六、卸载 Alist
# 停止并禁用服务
sudo systemctl stop alist
sudo systemctl disable alist
# 删除文件和目录
sudo rm -rf /opt/alist /etc/systemd/system/alist.service
# 重载 Systemd
sudo systemctl daemon-reload
通过以上步骤,你已经完成了 Alist 的手动安装和系统服务配置。这种方式比一键脚本更可控,适合生产环境使用。