HTTP静态文件服务器gohttpserver

发表于 更新于 分类于 Waline： 阅读次数： 本文字数： 3.5k 阅读时长 ≈ 3 分钟
gohttpserver 是一款静态 HTTP 文件服务器。

本文软件是网友 yfst 推荐的，抱歉拖延到 7 月底才完成，又拖了这么久才发布~

什么是 gohttpserver ？

gohttpserver 要做最好的 HTTP 静态文件服务器，其采用 golang + vue 编写。具备人性化的 UI 体验，支持文件的上传，能为安卓和苹果安装包直接生成二维码。

gohttpserver 是多平台的，除了我们准备安装的 docker 版外，还支持各主流平台。

gohttpserver 除了本地文件服务器功能外，还有一些额外的功能，比如可以让本地的 ipa,apk 也能支持扫码下载，这对于开发来说应该是比较方便的功能。

安装

在群晖上以 Docker 方式安装。

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

卷

在 docker 文件夹中，创建一个新文件夹 gohttpserver，并在其中建一个子文件夹 data

文件夹 装载路径 说明
docker/gohttpserver/data /app/public 存放上传文件

端口

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

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
7050 8000

环境变量

gohttpserver 安装比较简单，这一步可以不设置，只设卷和端口就已经能正常使用了。

但是有些高级功能的开启，需要我们在 命令 中输入对应的参数，来对 gohttpserver 进行设置，例如：

  • 如果需要上传功能，请加 --upload；
  • 如果要新建文件和删除功能，请加 --delete；
  • 启用基本 http 身份验证，请加 --auth-type http --auth-http username:password
  • 更多的设置，请看官方的代码网站的说明，并根据自己的实际需要进行设置；

下图演示了上面几个参数

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文件夹 gohttpserver 和 子目录
mkdir -p /volume2/docker/gohttpserver/data

# 进入 gohttpserver 目录
cd /volume2/docker/gohttpserver

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name gohttpserver \
   -p 7050:8000 \
   -v $(pwd)/data:/app/public \
   codeskyblue/gohttpserver \
   --upload --delete --auth-type http --auth-http username:password

记得将 username 和 password 替换成你想要的账号和密码；

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
version: '3'

services:
  fileserver:
    image: codeskyblue/gohttpserver
    container_name: gohttpserver
    restart: unless-stopped
    ports:
      - 7050:8000
    volumes:
      - ./data:/app/public
    command: --upload --delete --auth-type http --auth-http username:password

同样要记得将 username 和 password 替换成你想要的账号和密码；

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 gohttpserver 和 子目录
mkdir -p /volume2/docker/gohttpserver/data

# 进入 gohttpserver 目录
cd /volume2/docker/gohttpserver

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

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

标准安装，也就是命令行中什么都没输入时

如果加了--upload ，会多一个 Upload 按钮

如果加了 --delete ，会多一个 垃圾桶 和一个 New Folder 按钮

如果加了 --auth-type http --auth-http username:password，首先会弹出登录框

功能比较简单，上一张官方的动图来演示主要的功能

高级

用户可以在目录中创建 .ghs.yml 文件来控制当前目录的存取规则

1
2
3
4
5
6
7
8
9
10
root 
  |-- foo
  |    |-- .ghs.yml
  |    |-- 1.txt 
  |    |-- 2.txt 
  |    |-- 3.txt 
  |    |-- 4.txt 
  |    `-- world.txt
  `-- bar
       `-- hello.txt

让我们先浏览下 foo 目录

现在假设我们要实现下面的效果：

  • foo 目录不能上传，不能新建目录和删除；
  • foo 目录中 2.txt 和 3.txt 不显示；

注意是不显示，而不是不能访问；

.ghs.yml 需要填入下面的内容

1
2
3
4
5
6
7
upload: false
delete: false
accessTables:
- regex: 2.txt
  allow: false
- regex: 3.txt
  allow: false

刷新页面，你会发现 2.txt 和 3.txt 不见了，也不能上传和删除了

但我们可以在路径后面加 ?json=true 查看目录和文件的详细信息，实际路径为 http://192.168.0.197:7050/foo?json=true

格式化之后看起来比较清楚

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
{
	"auth": {
		"upload": false,
		"delete": false,
		"users": null,
		"AccessTables": [{
			"Regex": "2.txt",
			"Allow": false
		}, {
			"Regex": "3.txt",
			"Allow": false
		}]
	},
	"files": [{
		"name": "4.txt",
		"path": "foo/4.txt",
		"type": "file",
		"size": 5,
		"mtime": 1659102355340
	}, {
		"name": "world.txt",
		"path": "foo/world.txt",
		"type": "file",
		"size": 3557,
		"mtime": 1658153450866
	}, {
		"name": ".ghs.yml",
		"path": "foo/.ghs.yml",
		"type": "file",
		"size": 101,
		"mtime": 1659113046044
	}, {
		"name": "1.txt",
		"path": "foo/1.txt",
		"type": "file",
		"size": 3557,
		"mtime": 1658153450866
	}]
}

所以你还是可以很轻松访问到隐藏文件的，比如：http://192.168.0.197:7050/foo/2.txt

参考文档

codeskyblue/gohttpserver: The best HTTP Static File Server, write with golang+vue
地址：https://github.com/codeskyblue/gohttpserver