• Goal: Make the best HTTP File Server.
• Features: Human-friendly UI, file uploading support, direct QR-code generation for Apple & Android install package.

Demo site

• 目标: 做最好的HTTP文件服务器
• 功能: 人性化的UI体验，文件的上传支持，安卓和苹果安装包的二维码直接生成。

Binaries can be downloaded from this repo releases

Tested with go-1.10, go-1.11

1. Support QRCode code generate
2. Breadcrumb path quick change
3. All assets package to Standalone binary
4. Different file type different icon
5. Support show or hide hidden files
6. Upload support (auth by token or session)
7. README.md preview
8. HTTP Basic Auth
9. Partial reload pages when directory change
10. When only one dir under dir, path will combine two together
11. Directory zip download
12. Apple ipa auto generate .plist file, qrcode can be recognized by iphone (Require https)
13. Plist proxy
14. Download count statistics
15. CORS enabled
16. Offline download
17. Code file preview
18. Edit file support
19. Global file search
20. Hidden work download and qrcode in small screen
21. Theme select support
22. OK to working behide Nginx
23. .ghs.yml support (like .htaccess)
24. Calculate md5sum and sha
25. Folder upload
26. Support sort by size or modified time
27. Add version info into index page
28. Add api /-/info/some.(apk|ipa) to get detail info
29. Add api /-/apk/info/some.apk to get android package info
30. Auto tag version
31. Custom title support
32. Support setting from conf file
33. Quick copy download link
34. Show folder size
35. Create folder
36. Skip delete confirm when alt pressed

go get -v github.com/codeskyblue/gohttpserver
cd $GOPATH/src/github.com/codeskyblue/gohttpserver
go build && ./gohttpserver

Or download binaries from github releases

Listen on port 8000 of all interfaces, and enable file uploading.

./gohttpserver -r ./ --port 8000 --upload

Use command gohttpserver --help to see more usage.

share current directory

docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver codeskyblue/gohttpserver

Share current directory with http basic auth

docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver \
  codeskyblue/gohttpserver \
  --auth-type http --auth-http username:password

Share current directory with openid auth. (Works only in netease company.)

docker run -it --rm -p 8000:8000 -v $PWD:/app/public --name gohttpserver \
  codeskyblue/gohttpserver \
  --auth-type openid

• Enable basic http authentication

  $ gohttpserver --auth-type http --auth-http username:password

• Use openid auth

  $ gohttpserver --auth-type openid --auth-openid https://login.example-hostname.com/openid/

• Enable upload

  $ gohttpserver --upload

• Enable delete and Create folder

  $ gohttpserver --delete

Add access rule by creating a .ghs.yml file under a sub-directory. An example:

---
upload: false
delete: false
users:
- email: "[email protected]"
  delete: true
  upload: true
  token: 4567gf8asydhf293r23r

In this case, if openid auth is enabled and user "[email protected]" has logged in, he/she can delete/upload files under the directory where the .ghs.yml file exits.

token is used for upload. see upload with curl

For example, in the following directory hierarchy, users can delete/uploade files in directory foo, but he/she cannot do this in directory bar.

root -
  |-- foo
  |    |-- .ghs.yml
  |    `-- world.txt 
  `-- bar
       `-- hello.txt

User can specify config file name with --conf, see example config.yml.

To specify which files is hidden and which file is visible, add the following lines to .ghs.yml

accessTables:
- regex: block.file
  allow: false
- regex: visual.file
  allow: true

This is used for server on which https is enabled. default use https://plistproxy.herokuapp.com/plist

./gohttpserver --plistproxy=https://someproxyhost.com/

Test if proxy works:

$ http POST https://someproxyhost.com/plist < app.plist
{
	"key": "18f99211"
}
$ http GET https://someproxyhost.com/plist/18f99211
# show the app.plist content

For example, upload a file named foo.txt to directory somedir

$ curl -F [email protected] localhost:8000/somedir
{"destination":"somedir/foo.txt","success":true}
# upload with token
$ curl -F [email protected] -F token=12312jlkjafs localhost:8000/somedir
{"destination":"somedir/foo.txt","success":true}

# upload and change filename
$ curl -F [email protected] -F filename=hi.txt localhost:8000/somedir
{"destination":"somedir/hi.txt","success":true}

Note: \/:*<>| are not allowed in filenames.

Recommended configuration, assume your gohttpserver listening on 127.0.0.1:8200

server {
  listen 80;
  server_name your-domain-name.com;

  location / {
    proxy_pass https://127.0.0.1:8200; # here need to change
    proxy_redirect off;
    proxy_set_header  Host    $host;
    proxy_set_header  X-Real-IP $remote_addr;
    proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header  X-Forwarded-Proto $scheme;

    client_max_body_size 0; # disable upload limit
  }
}

Refs: https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size

• How to generate self signed certificate with openssl

The search query follows common format rules just like Google. Keywords are seperated with space(s), keywords with prefix - will be excluded in search results.

1. hello world means must contains hello and world
2. hello -world means must contains hello but not contains world

Depdencies are managed by govendor

1. Build develop version. assets directory must exists

go build
./gohttpserver

2. Build single binary release

go generate .
go build -tags vfs

Theme are defined in assets/themes directory. Now only two themes are available, "black" and "green".

• Core lib Vue https://vuejs.org.cn/
• Icon from https://www.easyicon.net/558394-file_explorer_icon.html
• Code Highlight https://craig.is/making/rainbows
• Markdown Parser https://github.com/showdownjs/showdown
• Markdown CSS https://github.com/sindresorhus/github-markdown-css
• Upload support https://www.dropzonejs.com/
• ScrollUp https://markgoodyear.com/2013/01/scrollup-jquery-plugin/
• Clipboard https://clipboardjs.com/
• Underscore https://underscorejs.org/

Go Libraries

• vfsgen
• go-bindata-assetfs Not using now
• https://www.gorillatoolkit.org/pkg/handlers

The old version is hosted at https://github.com/codeskyblue/gohttp

This project is licensed under MIT.