zh/guide/install/manual

[giscus[bot]]

zh/guide/install/manual

AList v3的文档

https://alist.nn.ci/zh/guide/install/manual.html

[lemon-tree007]

openwrt安装后 如何在启动项内添加为自启动？

[lemon-tree007]

路径是否正确？

[Corpama]

可以在/etc/init.d中加启动项，让这个启动项去运行一个启动脚本，然后这个启动脚本再运行命令启动alist，但是一定要注意在这个脚本中加入cd，通过cd将working directory设置到alist所在的目录下。这样做是因为无法在init.d启动项中直接设置working directory。
ps.router的u要好一点，实测普通的armv7在使用web proxy时速度很慢。如果是软路由那就当我没说

[lemon-tree007]

大佬，这个脚本该如何写，之前的不需要start，直接./alist就行，现在怎么添加start命令

[Corpama]

/etc/init.d/alist:

#!/bin/sh /etc/rc.common
START=99
start(){
        sh /usr/local/alist/start.sh
}
stop(){
        # kill your pid
        kill -9 `ps | grep '/usr/local/alist/alist server' | grep -v 'grep' | awk '{print $1}'`
}
restart(){
        kill -9 `ps | grep '/usr/local/alist/alist server' | grep -v 'grep' | awk '{print $1}'`
        sh /usr/local/alist/start.sh
}

/usr/local/alist/start.sh:

#!/bin/bash
cd /usr/local/alist
/usr/local/alist/alist server >> /dev/null 2>&1 &

[agczsz]

安装luci包的alist就会作为系统服务开机自启

[BeFondOfSunday]

Windows如何自启动

[xiaoliziapp]

怎么设置服务启动，出个教程呗

[TSStudio]

本质上是使用srvany.exe给alist加壳，让windows能把alist当成服务。instsrv+srvany将普通exe注册成服务有很多教程了，可以自己去看，记得argument是server。

[yechaogui]

注意是反斜杠的 .\alist.exe server

[tzhx12]

使用计划任务程序

[xuchaoxin1375]

开机自动运行配置(守护进程)👺

windows上实现开机后台运行软件或服务的方式有不少,比如存放快捷方式到startup目录,注册计划任务,打包成服务等,还有相关的图形界面软件专门设置alist的自启动服务(但是我认为没有必要)

你可以查看alist的运行日志,来检查某次运行或启动是否有异常,日志文件位置由alist的配置文件data/config.json中的log段指定 [配置文件 | AList文档 (nn.ci)](https://alist.nn.ci/zh/config/configuration.html)

一键配置

windows用户注册alist(cli版)服务计划任务的注册,实现开机自启动
使用powershell管理员权限运行

function Register-AlistStartup
{
   <# 
   .SYNOPSIS
   windows用户注册alist(cli版)服务计划任务的注册,实现开机自启动
   使用powershell管理员权限运行👺
   
   .DESCRIPTION
   请根据需要修改下面的$FilePath路径中的alist.exe部分，否则不起作用,其余部分可以不改动
   #>
    param(
        $TaskName='StartupAlist',
        $UserId='System',
        $FilePath = ' C:\exes\alist\alist.exe  ',#修改为自己的alist程序 路径👺
        $Directory #alist的起始目录
    )

    if (!$Directory)
    {

        $Directory = Split-Path -Path $FilePath -Parent
    }
    # 输出目录路径

    $action = New-ScheduledTaskAction -Execute $FilePath -Argument 'server' -WorkingDirectory $Directory
    # 定义触发器
    $trigger = New-ScheduledTaskTrigger -AtStartup
    # 任务执行主体设置(以System身份运行,且优先级最高,无论用户是否登陆都运行,适合于后台服务，如aria2，chfs，alist等)
    $principal = New-ScheduledTaskPrincipal -UserId $UserId -LogonType ServiceAccount -RunLevel Highest
    # 这里的-UserId 可以指定创建者;但是注意,任务创建完毕后,不一定能够立即看Author(创建者)字段的信息,需要过一段时间才可以看到,包括taskschd.msc也是一样存在滞后

    $settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable

    # 创建计划任务
    Register-ScheduledTask -TaskName $TaskName -Action $action `
        -Trigger $trigger -Settings $settings -Principal $principal
    
}

#使用方法
## 注册alist计划任务(默认的计划任务名为StartupAlist，启动角色为System,修改为自己当前用户账户也是可以的)

Register-AlistStartup 

其他相关命令

• 检查计划任务

  Get-ScheduledTask -TaskName startupalist

• 立刻执行启动alist服务计划任务：

  Start-scheduledTask -TaskName StartupAlist 

• 立即暂停Alist计划任务

  Stop-ScheduledTask -TaskName StartupAlist

• 检查Alist进程是否正在运行

  ps alist*

  如果返回结果,表明有相关进程在运行

• 移除计划任务

Unregister-ScheduledTask -TaskName startupalist # -Confirm:$false #是否免询问移除计划任务

相关参考

• [守护进程开机自启动 | AList文档 (nn.ci)](https://alist.nn.ci/zh/guide/install/manual.html#守护进程)

  • 文档可能移除这一部分(过时的开机自启方式)

• [windows配置开机自启动软件或脚本-CSDN博客](https://blog.csdn.net/xuchaoxin1375/article/details/136098694?csdn_share_tail={"type"%3A"blog"%2C"rType"%3A"article"%2C"rId"%3A"136098694"%2C"source"%3A"xuchaoxin1375"})

[JasonZhao21]

大佬，请问一下windows10安装过程中到start server @ 0.0.0.0:5244这一句就不再执行了，这是什么问题呀？

[cancundeyingzi]

,,,,还要执行什么?

[JasonZhao21]

这一句运行完不是应该返回一个结果嘛，就是运行到这一句的时候没运行完，没有返回结果

[cancundeyingzi]

这一句运行完不是应该返回一个结果嘛，就是运行到这一句的时候没运行完，没有返回结果

上一句不是返回的结果吗？他还要返回什么结果？

[wyf9]

这一句表示alist已经在0.0.0.0:5244启动，就是服务正在运行了的意思。如果不运行了服务器不就关了吗？
如果你希望运行时不显示窗口可以参考上面的vbs或注册windows服务，如果懒得搞就直接把窗口丢一边（别关）即可。

[TTQDM]

win的alist怎么卸载？

[BeFondOfSunday]

直接删除就行吧，如果设置开机自启把快捷方式删了

[TTQDM]

好的，谢谢

[hkqidf4]

Aria2 not ready.是什么问题，显示star server后不能打开登录界面

[wshaow]

请问解决了吗，我也有这个问题

[wshaow]

我这解决了，只需要在点一下底下的管理就可以了

[lazlo95152]

我也一样

[lazlo95152]

请问点哪里的管理？

[myjconan]

因为你还没添加网盘路径所以找不到地址，点页面下面的管理，添加至少一个网盘就正常了

[KimiMeta]

请问，网件R7000路由器，刷的梅林380固件，应该选择alist哪个安装包？是alist-linux-arm-7.tar.gz吗？

[xiyuyeyun]

离线安装吗？

[ryOuOkk]

哪位大佬知道mac怎么设置自启动

[hengzi-hub]

为什么在我的Mac电脑中~/Library/LaunchAgents/该路径下没有ci.nn.alist.plist这个文件，哪位大佬能帮忙解答下

[CrazyJasonwell]

在maci下按网站教程坐了自启动设置，总是不成功，看不到进程，只好手动启动，这个时候总是提示是否接受网络传入，不能自启动是不是这个问题？怎么解决呢？

[Aodkasd]

官方的alist守护程序我照着来写，但还是不成功。有很多视频会教mac如何安装alist，可就是没有教怎么写alist的mac自启动

[safirosi]

path/to/working/dir 为 AList的工作路径
这个工作路径是哪个路径啊？

[wyf9]

@safirosi
这个工作路径一般是alist文件所在的路径

[To-Matrix]

http://ip:5244 中的 ip 是指哪个 ip 呀?

[To-Matrix]

我是windows系统，还想问下 unzip alist-xxx.zip 是在cmd中写吗，提示说没有unzip这个功能

[zhiyuto]

http://127.0.0.1:5244

[yechaogui]

这个是winrar的解压功能吧，可以手动解压就可以了

[tzhx12]

localhost

[ryOuOkk]

本地启动127.0.0.1在 2022年10月26日，13:47，To-Matrix ***@***.***> 写道： http://ip:5244 中的 ip 是指哪个 ip 呀? —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you commented.Message ID: ***@***.***>

[CoderYiXin]

0.0.0.0 你网卡内的所有IP都监听了！

[ryOuOkk]

win直接解压在 2022年10月26日，13:50，To-Matrix ***@***.***> 写道： 我是windows系统，还想问下 unzip alist-xxx.zip 是在cmd中写吗，提示说没有unzip这个功能 —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because you commented.Message ID: ***@***.***>

[wyf9]

windows的命令行是不自带unzip的，直接拿一般的解压缩软件解压到同目录即可

[liujinbao3000]

软件真好,十分感谢

[myjconan]

我已收到您的邮件，谢谢！

[fusheng945]

登录127.0.0.1:5244后出现这个错误如何解决 failed get storage: can't find storage with rawPath: / 获取存储失败：无法找到 /

[pyx378952739]

遇到同样的问题，但是意外的找到了办法：就直接点击下方的登录，登录之后如果还是这个页面，就再点下方的管理。即可。

[shenlan823]

macos 怎么在本地搭建，" ./alist server "运行不了。

[TUXUEZHAO]

同求

[yechaogui]

注意：是反斜杠的 .\alist.exe server

[thezwa]

我想在Termux里面的Ubuntu里面添加alist自启动，请问如何操作？

[at86397388]

Alist没有在更新了么？

[zhouhaoo]

# opkg print-architecture
arch all 1
arch noarch 1
arch mipsel_24kc 10

请问大佬们，mipsel_24kc下载什么架构。。。

[1205129045x]

用你发的vbs脚本启动，输入原来用cmd设置的密码，提示密码错误，这是什么原因

[jie96leo]

我也是这个原因，大佬解决了吗

[gamersky998]

● alist.service - alist
Loaded: loaded (/usr/lib/systemd/system/alist.service; enabled; vendor preset: enabled)
Active: failed (Result: exit-code) since Wed 2024-01-10 02:14:23 CST; 2min 8s ago
Process: 31112 ExecStart=/root/alist/alist server (code=exited, status=210/CHROOT)
Main PID: 31112 (code=exited, status=210/CHROOT)

Jan 10 02:14:23 onecloud systemd[1]: alist.service: Failed with result 'exit-code'.
Jan 10 02:14:23 onecloud systemd[1]: alist.service: Service hold-off time over, scheduling restart.
Jan 10 02:14:23 onecloud systemd[1]: Stopped alist.
Jan 10 02:14:23 onecloud systemd[1]: alist.service: Start request repeated too quickly.
Jan 10 02:14:23 onecloud systemd[1]: Failed to start alist.
Jan 10 02:14:23 onecloud systemd[1]: alist.service: Unit entered failed state.
Jan 10 02:14:23 onecloud systemd[1]: alist.service: Failed with result 'exit-code'.
root@onecloud:# ^C
root@onecloud:#

无法设置自启动，ALIST路劲设置过的了

[wyf9]

检查一下：

1. 配置文件(/usr/lib/systemd/system/alist.service)
2. 你AList可执行文件的权限 /root/alist/alist
3. 下载来AList是不是你机器架构的(看机器名为onecloud，可能是armv8或armv7l之类，可以用 uname -a 看)

关于2，3两点建议自己运行测试下

附上我的配置：

[Unit]
Description=alist
After=network.target
 
[Service]
Type=simple
WorkingDirectory=/opt/alist
ExecStart=/opt/alist/alist server
Restart=on-failure
 
[Install]
WantedBy=multi-user.target

[at86397388]

为什么突然登录alist网页成了一片空白？什么都没有，没有错误提示，连登录界面都看不到

[qfycopilotuser]

我也是这样，alist和浏览器卸载重装好几次了，搜网上也没相关说法，还以为是自己坏了

[17855069]

我的也是这样，有的电脑用Medge浏览器能打开，有的电脑又不行，不知道什么问题

[dudupoppy]

alist在127页面那挂了好几个云盘，像115 啊 阿里云之类，我怎么放到电脑播放器哪里看电影呢

[wyf9]

可以使用支持WebDAV协议的播放器连接AList，具体可以看官方的 WebDAV

[dudupoppy]

This is a command line tool.

You need to open cmd.exe and run it from there.

这个有啥用呢

[wyf9]

上下文不全

翻译：
这是一个命令行工具。
你需要打开 cmd.exe 然后从那里运行它。

[dudupoppy]

我就花了50块钱买了那个激活码，懒得弄了，但是我不会搞什么映射之类，好麻烦。😞

…

---Original--- From: ***@***.***> Date: Sun, Mar 3, 2024 09:32 AM To: ***@***.***>; Cc: ***@***.******@***.***>; Subject: Re: [alist-org/docs] zh/guide/install/manual (Discussion #25) 我的也是这样，有的电脑用Medge浏览器能打开，有的电脑又不行，不知道什么问题 — Reply to this email directly, view it on GitHub, or unsubscribe. You are receiving this because you commented.Message ID: ***@***.***>

[at86397388]

能否增加以下功能：
1、后台记录所有登录的设备名称。
2、可以撤销已登录的设备的登录。

[Ayl-nz]

-bash: ./alist: cannot execute binary file: Exec format error
这个怎么解决？

[wyf9]

Exec format error 翻译：可执行文件格式错误

可能是你下载的alist架构和你系统架构不同，建议先用 uname -a (或自行搜索) 看一下你的系统架构，下载对应的版本

如:

root@onecloud:~# uname -a
Linux onecloud 6.6.32-current-meson #1 SMP Sat May 25 14:22:56 UTC 2024 armv7l GNU/Linux

则我的系统架构就为 armv7l

[jie96leo]

守护完了，密码就是错误！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！命令改了或者随机重置也不行

[wyf9]

建议检查启动路径(cwd)是否是alist可执行文件所在的路径，alist配置文件默认是存储在启动时所在路径的

[cucumba226]

请问，我的openwrt安装alist时错误提示：Collected errors:

• pkg_hash_check_unresolved: cannot find dependency kmod-fuse for libfuse1
• pkg_hash_fetch_best_installation_candidate: Packages for libfuse1 found, but incompatible with the architectures configured
• satisfy_dependencies_for: Cannot satisfy the following dependencies for alist:
• kmod-fuse
• opkg_install_cmd: Cannot install package alist.
  这个怎么弄，必须重新刷openwrt吗？请各位大神指教，谢谢！

[BigCleverKerryWang]

【一直在加载第二步】
这是怎么回事：
【第五行开头】
↓↓↓
PS F:\BigClever_SUPER_room\Good_Things\alist> .\alist.exe storage disable /open
INFO[2024-07-26 23:33:37] reading config file: data\config.json
INFO[2024-07-26 23:33:37] load config from env with prefix: ALIST_
INFO[2024-07-26 23:33:37] init logrus...
ERRO[2024-07-26 23:33:37] failed to query storage: record not found
github.com/alist-org/alist/v3/internal/db.GetStorageByMountPath
/source/internal/db/storage.go:59
github.com/alist-org/alist/v3/cmd.init.func11
/source/cmd/storage.go:35
github.com/spf13/cobra.(*Command).execute
/go/pkg/mod/github.com/spf13/[email protected]/command.go:989
github.com/spf13/cobra.(*Command).ExecuteC
/go/pkg/mod/github.com/spf13/[email protected]/command.go:1117
github.com/spf13/cobra.(*Command).Execute
/go/pkg/mod/github.com/spf13/[email protected]/command.go:1041
github.com/alist-org/alist/v3/cmd.Execute
/source/cmd/root.go:22
main.main
/source/main.go:6
runtime.main
/go/pkg/mod/golang.org/[email protected]/src/runtime/proc.go:271
runtime.goexit
/go/pkg/mod/golang.org/[email protected]/src/runtime/asm_amd64.s:1695

[BigCleverKerryWang]

知道了，要等一会

[xuchaoxin1375]

开机自动运行配置(守护进程)👺

windows上实现开机后台运行软件或服务的方式有不少,比如存放快捷方式到startup目录,注册计划任务,打包成服务等,还有相关的图形界面软件专门设置alist的自启动服务(但是我认为没有必要)

你可以查看alist的运行日志,来检查某次运行或启动是否有异常,日志文件位置由alist的配置文件data/config.json中的log段指定 [配置文件 | AList文档 (nn.ci)](https://alist.nn.ci/zh/config/configuration.html)

一键配置

windows用户注册alist(cli版)服务计划任务的注册,实现开机自启动
使用powershell管理员权限运行

function Register-AlistStartup
{
   <# 
   .SYNOPSIS
   windows用户注册alist(cli版)服务计划任务的注册,实现开机自启动
   使用powershell管理员权限运行👺
   
   .DESCRIPTION
   请根据需要修改下面的$FilePath路径中的alist.exe部分，否则不起作用,其余部分可以不改动
   #>
    param(
        $TaskName='StartupAlist',
        $UserId='System',
        $FilePath = ' C:\exes\alist\alist.exe  ',#修改为自己的alist程序 路径👺
        $Directory #alist的起始目录
    )

    if (!$Directory)
    {

        $Directory = Split-Path -Path $FilePath -Parent
    }
    # 输出目录路径

    $action = New-ScheduledTaskAction -Execute $FilePath -Argument 'server' -WorkingDirectory $Directory
    # 定义触发器
    $trigger = New-ScheduledTaskTrigger -AtStartup
    # 任务执行主体设置(以System身份运行,且优先级最高,无论用户是否登陆都运行,适合于后台服务，如aria2，chfs，alist等)
    $principal = New-ScheduledTaskPrincipal -UserId $UserId -LogonType ServiceAccount -RunLevel Highest
    # 这里的-UserId 可以指定创建者;但是注意,任务创建完毕后,不一定能够立即看Author(创建者)字段的信息,需要过一段时间才可以看到,包括taskschd.msc也是一样存在滞后

    $settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable

    # 创建计划任务
    Register-ScheduledTask -TaskName $TaskName -Action $action `
        -Trigger $trigger -Settings $settings -Principal $principal
    
}

#使用方法
## 注册alist计划任务(默认的计划任务名为StartupAlist，启动角色为System,修改为自己当前用户账户也是可以的)

Register-AlistStartup 

其他相关命令

• 检查计划任务

  Get-ScheduledTask -TaskName startupalist

• 立刻执行启动alist服务计划任务：

  Start-scheduledTask -TaskName StartupAlist 

• 立即暂停Alist计划任务

  Stop-ScheduledTask -TaskName StartupAlist

• 检查Alist进程是否正在运行

  ps alist*

  如果返回结果,表明有相关进程在运行

• 移除计划任务

Unregister-ScheduledTask -TaskName startupalist # -Confirm:$false #是否免询问移除计划任务

相关参考

• [守护进程开机自启动 | AList文档 (nn.ci)](https://alist.nn.ci/zh/guide/install/manual.html#守护进程)

  • 文档可能移除这一部分(过时的开机自启方式)

• [windows配置开机自启动软件或脚本-CSDN博客](https://blog.csdn.net/xuchaoxin1375/article/details/136098694?csdn_share_tail={"type"%3A"blog"%2C"rType"%3A"article"%2C"rId"%3A"136098694"%2C"source"%3A"xuchaoxin1375"})

[Mora-na]

希望能用homebrew安装