轻量级的门户Muximux

发表于 2022-06-17 更新于 2025-10-28 分类于各种折腾 Waline：阅读次数：本文字数： 2.2k 阅读时长 ≈ 2 分钟

Muximux 是轻量级 Web 应用程序的门户。

昨天接到通知，这周六和上周一样，全区全员核酸筛查，还是一大早一次抗原 + 一次核酸的模式。

什么是 Muximux ？

Muximux 是一个轻量级的门户，可以查看和管理您的 HTPC 应用程序，而无需运行任何东西，只需要一个支持 PHP 的网络服务器。使用 Muximux，您无需打开多个选项卡，也无需为所有应用程序的 URL 添加书签。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 muximux ，选择第一个 linuxserver/muximux，版本选择 latest。

卷

在 docker 文件夹中，创建一个新文件夹，并将其命名为 muximux，再建一个子文件夹 config

文件夹	装载路径	说明
`docker/muximux/config`	`/config`	存放设置

端口

本地端口不冲突就行，不确定的话可以用命令查一下

1 2	# 查看端口占用 netstat -tunlp \| grep 端口号

本地端口	容器端口
`2780`	`80`
`2743`	`443`

默认有2个端口

老苏局域网用不上 443 ，反代也用不上 443，所以删了只留下了 80 端口，你要留着也没问题

环境

可变	值
`TZ`	设为 `Asia/Shanghai`
`PUID`	设为 `1000`
`PGID`	设为 `1000`

问题

这里有个比较大的坑，容器在启动后会有一个在 github 上拉取代码的动作，但是众所周知 github 经常会抽风，所以如果你看到日志里有下面的内容，说明代码拉取失败了

如果这个时候你在浏览器中输入 http://群晖IP:2780 ，只能看到失败的界面

下载代码

方法一

这个方法需要在容器内操作，而且还要会使用 vi 编辑器，难度略高一点

老苏查了一下，在容器的 /etc/cont-init.d/40-install 中有下载动作，容器内部带 vi 编辑器，可以直接编辑，在 git 地址前直接挂代理

1 2	# 编辑 40-install 文件 vi /etc/cont-init.d/40-install

将 git clone https://github.com/mescon/Muximux /config/www/muximux

改为 git clone https://ghproxy.com/https://github.com/mescon/Muximux /config/www/muximux

保存后重启容器

方法二

这个方法相对简单，只要新建一个文件，并将文件丢到群晖中

或者也可以在本地新建一个 40-install 文件，文件内容如下：

#!/usr/bin/with-contenv bash

# Set version
MUXIMUX_COMMIT=$(cat /version.txt)

# fetch site
[[ ! -d /config/www/muximux/.git ]] && \
	git clone https://ghproxy.com/https://github.com/mescon/Muximux /config/www/muximux
	git --git-dir=/config/www/muximux/.git --work-tree=/config/www/muximux checkout ${MUXIMUX_COMMIT}

# permissions
chown -R abc:abc \
	/config/www

将文件传到 /docker/muximux/config/custom-cont-init.d 目录中

同样也需要重新启动容器，等待代码下载完成。

方法三

这个方法最简单，下载 zip 包，解压后上传到群晖即可

在浏览器中打开：https://github.com/mescon/Muximux 直接下载 zip 文件

将解压的文件

放入到 config/www/muximux

运行

在浏览器中输入 http://群晖IP:2780 就能看到主界面

点左下角的齿轮进入 Settings，老苏点了 Remove all –> Save and Reload，把已有的菜单都删了

接下来就可以按照自己的应用逐个通过 Add new 添加了，老苏加了个 portainer，内置的图标多达 3508 个

完成后别忘了 Save and Reload

点击 portainer 图标

采用了页面嵌入的方式，右上角是 刷新 和 设置 按钮

认证

如果想要设置认证，只要在设置中勾选 Authentication，一定记得修改密码

Save and Reload 之后就出现了登录界面

如果忘记了密码，需先找到 /docker/muximux/config/www/muximux 目录中的 settings.ini.php

先要修改文件的权限，必须勾选 写入，不然文件内容修改后看起来似乎是删了，但是再次打开内容还在

打开文件，找到 authentication = "true"，将其删除

下面红框中的用户名和密码删不删都行

参考文档

mescon/Muximux: A lightweight way to manage your HTPC
地址：https://github.com/mescon/Muximux

linuxserver/docker-muximux
地址：https://github.com/linuxserver/docker-muximux

linuxserver/muximux - Docker Image | Docker Hub
地址：https://hub.docker.com/r/linuxserver/muximux