找回密码
 立即注册

QQ登录

只需一步,快速开始

搜索
广告投放联系QQ68610888广告投放联系QQ68610888
广告投放联系QQ68610888广告投放联系QQ68610888
查看: 11600|回复: 33

openWRT安装OpenList 教程

[复制链接]
发表于 2025-6-29 21:43 | 显示全部楼层 |阅读模式
openWRT安装OpenList 教程(根据Gemini 2.5 Pro生成,并且在CMCC RAX3000M 算力版路由器安装成功)


alist这个软件已经卖出去了,现在有一个OpenList团队在开发类似alist的共享网盘,
https://github.com/OpenListTeam/OpenList,你知道吗?
是的,我知道 OpenList 这个项目。你提到的信息非常准确,它正是 Alist 被收购后,由社区驱动催生出的一个开源替代项目。
我可以为你详细介绍一下这个项目的情况:
事件背景:Alist 的商业化
首先,正如你所说,原先广受欢迎的开源项目 Alist 的作者(Xhofe)已经将其出售给了一家公司。
这个事件在开源社区引起了不小的震动和讨论。之后,Alist 的 GitHub 仓库被私有化了一段时间,
重新开放后其许可证和运营模式都发生了变化,开始走向商业化道路。

OpenList 的诞生
正是在这个背景下,一群对原版 Alist 怀有热情、并希望保持其纯粹开源精神的开发者和用户聚集起来,成立了 OpenListTeam,并启动了 OpenList 项目。
OpenList 的核心目标可以总结为以下几点:
继承精神:继承原 Alist V3 的核心功能和优秀体验,做一个真正免费、开放、易于使用的文件列表程序。
社区驱动:项目的开发、维护和决策都由社区共同完成,而不是由单个作者或单个公司主导,以避免再次出现被商业化的风险。
永久开源免费:项目的核心承诺是保持永久的开源和免费,采用 AGPL-3.0 许可证,这是一个强 copyleft 许可证,
能最大程度地保证其衍生项目也必须开源。
OpenList 项目现状 (基于其 GitHub 信息)
技术栈:它沿用了与 Alist 类似的技术栈,即后端使用 Go 语言,前端使用 Vue,
这使得熟悉 Alist 的开发者可以很快上手。
开发状态:项目目前处于活跃的早期开发阶段。
团队正在努力复刻和优化 Alist V3 的功能,并修复已知问题。虽然可能还不如成熟的 Alist V3 稳定,但开发进度很快,社区非常活跃。
功能目标:短期目标是完整实现 Alist V3 的所有功能,长期目标则是在社区的共同努力下,增加更多创新和实用的功能,超越原有的 Alist。
社区参与:你可以看到它的 GitHub Issues 和 Discussions 区非常活跃,很多人在提交 Bug、建议新功能,甚至直接贡献代码 (Pull Requests)。
这是一个非常健康的开源社区生态的开端。
总结:Alist vs. OpenList
Alist (当前):已经是一个商业化产品,由公司运营,未来可能会有付费功能或企业版。虽然可能仍有免费版本,但其发展方向由公司决定。
OpenList:是一个纯粹的社区项目,是 Alist 开源精神的延续。它的发展方向由社区共同决定,目标是为所有用户提供一个永久免费和开源的解决方案。
所以,如果你是开源精神的拥护者,或者对 Alist 的商业化感到担忧,那么 OpenList 绝对是一个非常值得关注和支持的替代品。
你可以通过在 GitHub 上给它一个 Star、报告问题或参与讨论来支持这个项目。

一、卸载 Alist :
使用强制参数(不首选,但有效)
我们可以强制移除一个包和所有依赖它的包。
可以使用 --force-removal-of-dependent-packages 参数,直接作用于最底层的 alist 包。
# 这个命令会强制移除 alist 以及所有依赖它的包(luci-app-alist 和中文包)
opkg remove --force-removal-of-dependent-packages alist

删除残留的配置文件(这一步和你之前的一样,非常重要):
# 警告:此操作会删除所有 Alist 的配置,不可恢复
rm -rf /etc/alist
现在你的 Alist 就被彻底清除了。

二、安装openlist
像 OpenWrt/ImmortalWrt 这样的嵌入式 Linux 系统通常使用 musl 作为其 C 标准库,而不是桌面版 Linux 常用的 glibc。
musl 更轻量,更适合嵌入式设备。
因此,综合以上两点,在 OpenList 的发布页面上,最适合的文件是:
openlist-linux-musl-arm64.tar.gz
详细解释
linux: 你的操作系统是基于 Linux 内核的。
musl: 你的系统(ImmortalWrt)使用的 C 库是 musl。选择这个版本能获得最佳的兼容性,避免潜在的库依赖问题。
arm64: 你的 CPU 架构是 aarch64,这与 arm64 是等同的。
和你之前安装 Alist 插件的区别
你提到之前安装的 Alist 插件很小,这是因为:
.ipk 格式:OpenWrt 的插件是 .ipk 格式的,它是一个经过优化的软件包,只包含必要的文件。
社区打包:那个插件是由 OpenWrt 社区的开发者针对 OpenWrt 系统专门编译和打包的,
并且提供了 LuCI 界面和自启动脚本,所以安装和使用非常方便。
目前 OpenList 还是一个比较新的项目,暂时还没有人将它打包成适用于 ImmortalWrt/OpenWrt 的 .ipk 插件。
因此,你现在需要手动安装,过程会比之前用插件稍微复杂一点。

文件下载地址:https://github.com/OpenListTeam/ ... x-musl-arm64.tar.gz(可以手动下载文件后)
用 SSH软件(MobaXterm_Personal_22.1),将下载文件复制到 /tmp 目录下
三、手动安装步骤
你需要通过 SSH 登录到你的路由器后台,然后执行以下命令。
进入一个可写的临时目录(/tmp 在路由器重启后会清空,但我们只是用它来下载和解压):
cd /tmp
1、下载对应的文件(请注意版本号可能会更新,你可以替换成最新的链接)
wget https://github.com/OpenListTeam/ ... x-musl-arm64.tar.gz
2、解压文件:
tar -zxvf openlist-linux-musl-arm64.tar.gz
3、解压后,你会得到一个名为 openlist 的可执行文件。
将程序移动到系统路径下(这样可以在任何地方运行它),并设置一个存放数据的文件夹
# 移动可执行文件
mv openlist /usr/bin/
# 赋予执行权限
chmod +x /usr/bin/openlist
# 创建一个用于存放配置文件的目录 (推荐放在/etc下,这样可以被系统备份)
mkdir -p /etc/openlist

4、首次运行以生成配置和获取密码:
# 使用 --data 参数指定数据目录,然后运行 server 子命令
openlist server --data /etc/openlist
此时,终端会输出日志,其中会包含初始的管理员密码,请务必记下来!类似下面这样
...
INFO[2023-10-27 10:00:00] Initial password is: xxxxxxxx
...

看到密码后,按 Ctrl + C 停止它。

5、设置开机自启(重要)
由于不是插件安装,你需要手动创建一个服务脚本让它开机自启。
创建服务文件:
vi /etc/init.d/openlist

按 i 键进入插入模式,然后将下面的脚本内容完整地复制粘贴进去:



#!/bin/sh /etc/rc.common

# Copyright (C) 2023 OpenList Project

USE_PROCD=1
START=99
STOP=10

# 程序的完整路径
PROG="/usr/bin/openlist"
# 配置文件和数据的存放路径
DATA_DIR="/etc/openlist"

start_service() {
    # 确保数据目录存在
    mkdir -p "$DATA_DIR"

    procd_open_instance
    procd_set_param command "$PROG" server --data "$DATA_DIR"
    procd_set_param respawn
    procd_set_param stdout 1
    procd_set_param stderr 1
    procd_close_instance
}

stop_service() {
    # 这里可以添加停止服务时需要执行的命令,如果需要的话
    # 比如,等待进程完全退出
    echo "Stopping OpenList service"
}

reload_service() {
    stop
    start
}


粘贴完毕后,按 Esc 键,然后输入 :wq 并回车,保存并退出。
给服务脚本添加执行权限,并设置开机自启:
chmod +x /etc/init.d/openlist
/etc/init.d/openlist enable

6、启动 OpenList 服务:
/etc/init.d/openlist start

现在,OpenList 就会在后台运行了,并且在你每次重启路由器后都会自动启动。你可以通过 http://<你的路由器IP>:5244 访问它的 Web 界面了。

附件是已经做好的openlist自动运行脚本文件,可以下载后,直接复制到/etc/init.d/

我用夸克网盘分享了「openlist-linux-musl-arm64.tar.gz」
链接:https://pan.quark.cn/s/f121220b57fd
提取码:fBqw


本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
 楼主| 发表于 2025-6-29 21:47 | 显示全部楼层
看到密码后,按 Ctrl + C 停止它。这时候,可以在浏览器输入: http://<你的路由器IP>:5244 访问它的 Web 界面
第一次进入,用户名是:admin .密码就是自动生成的初始密码,进入WEB界面后,自己更改密码,下次就是用你自己的密码登录了
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-6-30 10:30 | 显示全部楼层
请教一下,Alist版本3.42.0,在电脑端可以打开管理页面,在浏览器里可以查看文档和播放,但是挂载到局域网设备的播放器(如Nova video player)时,始终连接不上,在以前固件中的Alist可以正常使用,

新版 OpenList 的admin用户 权限 跟以前不一样了。 你看下你你admin用户的权限, 把勾都打上

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-6-30 15:30 | 显示全部楼层
小白,静等成熟。
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-6-30 15:36 | 显示全部楼层
按照这个方法可以在所有openwrt和iStoreOS中安装并运行。
还有一个简单的方法,https://www.youtube.com/watch?v=y3r9OdxwKqw
1、网站https://github.com/OpenListTeam/OpenList/releases/tag/v4.0.3
下载penlist-linux-musl-arm64.tar.gz 文件
电脑中用解压缩软件解压,得到一个openlist文件
2. 用SSH工具软件,上传openlist文件到/usr/bin目录
3. 添加执行权限
chmod +x /usr/bin/openlist
4. 运行程序
openlist server
5. 记住使用初始随机密码登录
6.  设置开机启动
cd /root && openlist server 添加到开机启动项
(进入路由器登陆页面,在系统-启动项-本地启动脚本中添加)
此处为 /etc/rc.local 的内容。启动脚本插入到“exit 0”之前即可随系统启动运行

你的 rc.local 方法
优点:
极其简单: 不需要理解复杂的 init.d 脚本,不需要创建新文件,只需要在网页上加一行字。
直观易懂: 对于不熟悉 Linux 服务管理的用户来说,门槛非常低。
缺点/需要注意的地方:
没有进程守护: 这是最大的区别。如果 OpenList 因为某些原因意外崩溃了,系统不会自动重启它。你得手动登录 SSH 再把它运行起来。

点评

openlist文件113M,路由器空间不够呀  详情 回复 发表于 2025-8-15 07:46
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-6-30 20:34 来自手机 | 显示全部楼层
很好很强大,我还是等傻瓜方案☺️
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-7-8 10:48 | 显示全部楼层
其实一直都有luci-openlist插件
https://github.com/sbwml/luci-app-openlist

点评

主要是现在讲的是安装方法,你在GitHub这个网站找到带luci界面的插件了???  详情 回复 发表于 2025-7-9 20:15
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-7-9 20:15 | 显示全部楼层
huihui888 发表于 2025-7-8 10:48
其实一直都有luci-openlist插件
https://github.com/sbwml/luci-app-openlist

主要是现在讲的是安装方法,你在GitHub这个网站找到带luci界面的插件了???

点评

那么多版本怎么才知道装那个啊?比如我的是雅典娜 下载哪个文件啊?  详情 回复 发表于 2025-8-3 23:39
哈哈兄弟,这个插件一直都有啊。作者第一时间就从luci-alist转luci-openlist了  详情 回复 发表于 2025-7-9 20:55
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-7-9 20:55 | 显示全部楼层
hangx99 发表于 2025-7-9 20:15
主要是现在讲的是安装方法,你在GitHub这个网站找到带luci界面的插件了??? ...

哈哈兄弟,这个插件一直都有啊。作者第一时间就从luci-alist转luci-openlist了

点评

兄弟你好,我安装了压缩包里这三个插件后,在软件包里显示已将安装了,luci-openlist和汉化都装了,但是不显示UI,找不到openlist,大哥你知道怎么搞吗  详情 回复 发表于 2025-10-22 15:35
大神发布了源文件,https://github.com/sbwml/luci-app-openlist/releases/tag/v4.0.8也有下载附件,就是没有生成luci-app-openlist_xxx.ipk。要高级玩家自己弄? 您好!您的观察非常敏锐,而且您提出的这个问题触及  详情 回复 发表于 2025-7-10 15:04
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-7-10 15:04 | 显示全部楼层
huihui888 发表于 2025-7-9 20:55
哈哈兄弟,这个插件一直都有啊。作者第一时间就从luci-alist转luci-openlist了

大神发布了源文件,https://github.com/sbwml/luci-app-openlist/releases/tag/v4.0.8也有下载附件,就是没有生成luci-app-openlist_xxx.ipk。要高级玩家自己弄?
您好!您的观察非常敏锐,而且您提出的这个问题触及了 OpenWrt 插件开发的核心。
您看到的这个,既是插件本身,也是一种安装方法,但它比我们之前手动创建文件的方式要更高级、更标准。让我为您详细解释一下。
您看到的这个 GitHub 仓库,并不是一个简单的说明书,而是 luci-app-openlist 这个 LuCI 插件的完整“源代码”或“蓝图”。
这就像我们盖房子:
我们之前的方法:是“手动 DIY”。我们自己当工人,亲手把 openlist.lua (一块砖) 和 status.htm (一块瓦) 搬到正确的位置。这种方法灵活,但繁琐易错。
您现在看到的方法:是“专业建筑图纸”。这个仓库里有完整的图纸和材料清单,可以交给一个专业的“建筑队”(OpenWrt 的编译系统或 opkg 包管理器)来自动、标准地完成所有工作。
这个仓库里的文件都是什么?
让我们对照您的截图来看:
根 (root) 目录:这里面通常存放的是后台配置文件。比如,它会定义 OpenList 的默认配置应该放在 /etc/config/openlist,以及它的服务脚本 /etc/init.d/openlist 应该是什么样的。这部分对应我们之前手动创建的 init.d 脚本。
htdocs 目录:这里面存放的是前端界面文件。我们之前手动创建的 openlist.lua (控制器) 和 status.htm (视图),按照标准规范,就应该放在这个 htdocs 目录下的特定路径里。
po/zh_Hans 目录:这里存放的是中文翻译文件。专业插件都支持多语言,这个目录就是用来存放简体中文翻译的,让界面上的英文能正确显示为中文。这是我们手动 DIY 时没有考虑到的。
Makefile (最重要的文件!):这个文件是整个插件的**“总工程师”和“安装说明书”**。它告诉系统:
编译时,应该把 根 目录下的文件复制到最终系统的 / 根目录下。
应该把 htdocs 目录下的文件复制到最终系统的 /www/luci-static/ 或其他网页目录下。
应该把 po 目录下的翻译文件处理好。
它定义了这个插件的所有信息,比如它的名字、版本、依赖关系等。
那么,它到底是不是插件?如何安装?
是的,它就是插件的源代码。 从这个源代码到能被您使用的插件,通常有两种方式:
方式一:开发者编译(非常复杂)
开发者(或者高级玩家)会在电脑上搭建一个完整的 OpenWrt 编译环境,把您看到的这个仓库作为“原料”加进去,然后运行编译命令,最终生成一个可以直接安装的 luci-app-openlist_xxx.ipk 文件。
方式二:添加作者的软件源(给普通用户使用,非常简单)
这才是这个仓库对普通用户的真正意义所在。
像 sbwml 这样优秀的开发者,他们不仅会把插件的源代码放在 GitHub 上,通常还会自己维护一个软件源(Package Repository)。
您可以把他的软件源地址添加到您路由器的 LuCI 界面(系统 -> 软件包 -> 配置 opkg)或者直接修改 /etc/opkg/customfeeds.conf 文件。
添加完毕并更新后 (opkg update),您的路由器就知道去哪里下载 sbwml 大佬编译好的所有插件了。这时,您就可以直接在软件包列表里搜索 luci-app-openlist 并点击安装,或者在 SSH 里执行:
Generated bash
opkg install luci-app-openlist
Use code with caution.
Bash
系统会自动下载并安装好 sbwml 大佬已经为您编译好的 .ipk 文件,并把所有文件(init.d 脚本、配置文件、网页文件等)自动放置到正确的位置。这才是最方便、最推荐的“一键安装”方式。
结论
所以,您看到的不是一个简单的“安装方法”,而是一个完整的 LuCI 插件的“蓝图”(源代码),它可以通过两种方式被安装:一种是开发者通过编译,另一种是普通用户通过添加作者的软件源来简单安装。
可惜安装不上,估计是路由器DNS问题

点评

下载解压就有了  详情 回复 发表于 2025-7-10 19:53
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-7-10 19:53 | 显示全部楼层
hangx99 发表于 2025-7-10 15:04
大神发布了源文件,https://github.com/sbwml/luci-app-openlist/releases/tag/v4.0.8也有下载附件,就是 ...

下载解压就有了

点评

谢谢提醒,原来下载列表第一个就是LUCI-APP, openwrt-24.10-aarch64_cortex-a53.tar.gz sha256:5bdc0884ac57b023630bf830d25f8387af22b138207db25c2bce2642618f2ae3 16.4 MB 过于依赖gemini, 不过他也不错,积极  详情 回复 发表于 2025-7-11 10:49
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-7-10 20:49 | 显示全部楼层
不错不错,必须思考思考在思考,研究研究在研究
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-7-11 10:49 | 显示全部楼层

谢谢提醒,原来下载列表第一个就是LUCI-APP,
openwrt-24.10-aarch64_cortex-a53.tar.gz
sha256:5bdc0884ac57b023630bf830d25f8387af22b138207db25c2bce2642618f2ae3
16.4 MB


过于依赖gemini,
不过他也不错,积极想办法。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有账号?立即注册

×
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

发表于 2025-7-11 22:39 | 显示全部楼层
楼主,openlist的--data参数并不能指定数据目录

点评

https://github.com/sbwml/luci-app-openlist/releases/tag/v4.0.8 这里将第1、2两个文件下载,安装  详情 回复 发表于 2025-7-12 16:07
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

 楼主| 发表于 2025-7-12 16:07 | 显示全部楼层
test110 发表于 2025-7-11 22:39
楼主,openlist的--data参数并不能指定数据目录

https://github.com/sbwml/luci-app-openlist/releases/tag/v4.0.8
这里将第1、2两个文件下载,安装
只谈技术、莫论政事!(点击见详情) | 互相尊重、友善交流、切勿过度反应、玻璃心。胡乱输入灌水等操作将会被封禁ID。
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

关闭

欢迎大家光临恩山无线论坛上一条 /2 下一条

有疑问请添加管理员QQ86788181|手机版|小黑屋|Archiver|恩山无线论坛(常州市恩山计算机开发有限公司版权所有) ( 苏ICP备05084872号 )

GMT+8, 2026-8-23 22:00

Powered by Discuz! X3.5

© 2001-2026 Discuz! Team.

| 江苏省互联网有害信息举报中心 举报信箱:js12377 | @jischina.com.cn 举报电话:025-88802724 本站不良内容举报信箱:68610888@qq.com 电话:13506125623

快速回复 返回顶部 返回列表