Skip to content

[BUG] musl 构建在非 musl 环境启动失败(203/EXEC) #2334

@YYplus

Description

@YYplus

请确认以下事项

  • 我已确认阅读并同意 AGPL-3.0 第15条
    本程序不提供任何明示或暗示的担保,使用风险由您自行承担。

  • 我已确认阅读并同意 AGPL-3.0 第16条
    无论何种情况,版权持有人或其他分发者均不对使用本程序所造成的任何损失承担责任。

  • 我确认我的描述清晰,语法礼貌,能帮助开发者快速定位问题,并符合社区规则。

  • 我已确认阅读了OpenList文档

  • 我已确认没有重复的问题或讨论。

  • 我已确认是OpenList的问题,而不是其他原因(例如 网络依赖操作)。

  • 我认为此问题必须由OpenList处理,而非第三方。

  • 我已确认这个问题在最新版本中没有被修复。

  • 我没有阅读这个清单,只是闭眼选中了所有的复选框,请关闭这个 Issue 。

OpenList 版本(必填)

V4.2.0

使用的存储驱动(必填)

阿里云盘

问题描述(必填)

系统:Debian 13 x86_64
安装方式:官方一键管理脚本(Version: 1.3.4)
OpenList 版本:4.2.0
启动方式:systemd service
问题现象

服务启动失败,状态为 failed
systemd 报错:status=203/EXEC
手动检查后发现二进制为 musl 构建在 Debian glibc 环境下不兼容 应静态链接 musl 库
复现步骤

在 Debian 13 x86_64 使用一键脚本安装/更新 OpenList
执行 systemctl restart openlist
查看 systemctl status openlist
检查二进制类型:file /opt/openlist/openlist
检查依赖:ldd /opt/openlist/openlist
实际结果

下载到的是 musl 包(openlist-linux-musl-amd64.tar.gz)
file 显示解释器为 /lib/ld-musl-x86_64.so.1
ldd 输出异常(error while loading shared libraries)
systemd 启动失败(203/EXEC)
期望结果

Debian/Ubuntu 等 glibc 发行版应默认下载 glibc 构建(例如 openlist-linux-amd64.tar.gz) 应静态链接 musl 库
安装后服务可直接启动,不应出现 203/EXEC
定位信息

脚本 INSTALL 函数固定下载 openlist-linux-musl-$ARCH.tar.gz
脚本 UPDATE 函数同样固定下载 openlist-linux-musl-$ARCH.tar.gz
这会在 glibc 系统上引入兼容性问题

日志(必填)

● openlist.service - OpenList service
     Loaded: loaded (/etc/systemd/system/openlist.service; enabled; preset: enabled)
     Active: active (running) since Thu 2026-04-09 20:15:33 CST; 10min ago
 Invocation: 117dacfdcad94ce789d2db68a11b113c
   Main PID: 9134 (openlist)
      Tasks: 7 (limit: 1973)
     Memory: 22.8M (peak: 24.8M)
        CPU: 183ms
     CGroup: /system.slice/openlist.service
             └─9134 /opt/openlist/openlist server

Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z systemd[1]: Started openlist.service - OpenList service.
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: INFO[2026-04-09 20:15:33] reading config file: /opt/openlist/data/config.json
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: INFO[2026-04-09 20:15:33] load config from env with prefix: OPENLIST_
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: INFO[2026-04-09 20:15:33] max buffer limit: 84MB
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: INFO[2026-04-09 20:15:33] mmap threshold: 4MB
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: INFO[2026-04-09 20:15:33] init logrus...
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z openlist[9134]: start HTTP server @ 0.0.0.0:5244

Apr 09 19:45:34 iZbp1ggu0oqgitbngaa4v6Z systemd[1]: Started openlist.service - OpenList service.
Apr 09 19:45:34 iZbp1ggu0oqgitbngaa4v6Z (openlist)[2617]: openlist.service: Failed to execute /opt/openlist/openlist: No such file or directory
Apr 09 19:45:34 iZbp1ggu0oqgitbngaa4v6Z (openlist)[2617]: openlist.service: Failed at step EXEC spawning /opt/openlist/openlist: No such file or directory
Apr 09 19:45:34 iZbp1ggu0oqgitbngaa4v6Z systemd[1]: openlist.service: Main process exited, code=exited, status=203/EXEC
Apr 09 19:45:34 iZbp1ggu0oqgitbngaa4v6Z systemd[1]: openlist.service: Failed with result 'exit-code'.
Apr 09 20:15:33 iZbp1ggu0oqgitbngaa4v6Z systemd[1]: Started openlist.service - OpenList service.

-rwxr-xr-x 1 1001 1001 153850148 Apr  8 22:49 /opt/openlist/openlist
/opt/openlist/openlist: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked, interpreter /lib64/ld-linux-x86-64.so.2, BuildID[sha1]=d7c3cf6831595be6a5f3fd7c0e5e95059cc58138, stripped
      [Requesting program interpreter: /lib64/ld-linux-x86-64.so.2]
	linux-vdso.so.1 (0x00007f901be55000)
	libresolv.so.2 => /lib/x86_64-linux-gnu/libresolv.so.2 (0x00007f901be39000)
	libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x00007f901be34000)
	libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007f901bc40000)
	/lib64/ld-linux-x86-64.so.2 (0x00007f901be57000)


Step1: Debian 13 x86_64 上运行一键脚本 install/update
Step2: systemctl restart openlist
Step3: systemctl status 显示 203/EXEC
Step4: file 显示 interpreter 为 /lib/ld-musl-x86_64.so.1

配置文件内容(必填)

1

复现链接(可选)

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions