以下是手动安装 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 的手动安装和系统服务配置。这种方式比一键脚本更可控,适合生产环境使用。

最后修改:2025 年 04 月 10 日
如果觉得我的文章对你有用,请随意赞赏