{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/214", "result": {"data":{"issuesJson":{"id":"add02d0d-54ba-504f-876d-07c221bc30f6","title":"snowdreamtech/gserver: 使用 gin 和 golang 构建的简单静态 HTTP 服务器。跨平台，零配置","number":214,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Repossnowdreamtech/gserver
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

gserver

\n

\"dockeri.co\"

\n

A Simple Static HTTP Server built with gin and golang. cross platform, zero configuation

\n

Installation

\n

Binary

\n

Releases

\n

CLI

\n
go install github.com/snowdreamtech/gserver@latest
\n

Docker CLI

\n

Dockerhub

\n
docker pull snowdreamtech/gserver:latest\n  # snowdreamtech/gserver:alpine\n  # snowdreamtech/gserver:debian
\n

GitHub Container Registry

\n
docker pull ghcr.io/snowdreamtech/gserver:latest\n  # ghcr.io/snowdreamtech/gserver:alpine\n  # ghcr.io/snowdreamtech/gserver:debian
\n

Quay.io

\n
docker pull quay.io/snowdreamtech/gserver:latest\n  # quay.io/snowdreamtech/gserver:alpine\n  # quay.io/snowdreamtech/gserver:debian
\n

Usage

\n

CLI

\n
$ gserver --help\nA Simple Static HTTP Server built with gin and golang.\n\nUsage:\n   [flags]\n   [command]       \n\nAvailable Commands:\n  completion  Generate the autocompletion script for the specified shell\n  env         Print  version and environment info\n  help        Help about any command\n  version     Print the version number of\n\nFlags:\n      --autoindex-exact-size           For the HTML format, specifies whether exact file sizes should be output in the directory listing,\n                                       or rather rounded to kilobytes, megabytes, and gigabytes.\n      --autoindex-time-format string   this is the AutoIndex Time Format. (default \"2006-01-02 15:04:05\")\n      --basic                          If it is set, we will use HTTP Basic authentication.\n\n                                       Used together with -u, --user <user:password>.\n\n                                       Providing --basic multiple times has no extra effect.\n\n                                       Example:-u name:password --basic https://example.com\n  -c, --config string                  If it is not set, we will try with development.(json/env/ini/yaml/toml/hcl/properties\n      --contact-email string           HTTPS Contact Email\n      --enable-https                   If it is set, we will enable https.\n  -g, --gzip                           If it is set, we will compress with gzip. (default true)\n  -h, --help                           help for this command\n  -H, --host string                    Host optionally specifies the Http Address for the server to listen on,\n                                       in the form \"host:port\". If empty, \"host:\" (host localhost) is used.\n      --https-cert-dir string          HTTPS Cert Directory (default \"certs\")\n      --https-cert-file string         HTTPS Cert File\n      --https-domains stringArray      HTTPS Domains\n      --https-key-file string          HTTPS Key File\n      --https-port string              HTTPS PORT\n      --log-dir string                 The Log Directory which store access.log, error.log etc. (default \".\")\n  -P, --port string                    Port optionally specifies the TCP Port for the server to listen on,\n                                       in the form \"host:port\". If empty, \":port\" (port 8080) is used.\n      --preview-html                   For static web files, Whether preview them. (default true)\n      --rate-limiter string            Define a limit rate to several requests per hour.\n                                        You can also use the simplified format \"<limit>-<period>\"\", with the given\n                                        periods:\n\n                                        * \"S\": second\n                                        * \"M\": minute\n                                        * \"H\": hour\n                                        * \"D\": day\n\n                                        Examples:\n\n                                        * 5 reqs/second: \"5-S\"\n                                        * 10 reqs/minute: \"10-M\"\n                                        * 1000 reqs/hour: \"1000-H\"\n                                        * 2000 reqs/day: \"2000-D\"\n                                         (default \"5-S\")\n      --read-timeout int               ReadTimeout is the maximum duration for reading the entire\n                                       request, including the body. A zero or negative value means\n                                       there will be no timeout.\n\n                                       Because ReadTimeout does not let Handlers make per-request\n                                       decisions on each request body's acceptable deadline or\n                                       upload rate, most users will prefer to use\n                                       ReadHeaderTimeout. It is valid to use them both. (default 10)\n      --referer-limiter                Limit by referer\n      --speed-limiter int               Specify  the  maximum  transfer  rate you want curl to use - for\n                                       downloads.\n                                       The given speed is measured in bytes/second,\n  -u, --user string                    Specify the user name and password to use for server authentication.\n\n                                       The user name and passwords are split up  on  the  first  colon,\n                                       which  makes  it impossible to use a colon in the user name with\n                                       this option. The password can, still. (default \"admin:admin\")\n      --write-timeout int              WriteTimeout is the maximum duration before timing out\n                                       writes of the response. It is reset whenever a new\n                                       request's header is read. Like ReadTimeout, it does not\n                                       let Handlers make decisions on a per-request basis.\n                                       A zero or negative value means there will be no timeout. (default 10)\n  -w, --wwwroot string                 By default, the wwwroot folder is treated as a web root folder.\n                                       Static files can be stored in any folder under the web root and accessed with a relative path to that root.\n\nUse \" [command] --help\" for more information about a command.\n
\n

Docker CLI

\n
docker run -d \\\n  --name=gserver \\\n  -e TZ=Etc/UTC \\\n  -p 8080:8080 \\\n  -p 8443:8443 \\\n  -v /path/to/gserver:/var/lib/gserver  \\\n  --restart unless-stopped \\\n  snowdreamtech/gserver:latest\n  # snowdreamtech/gserver:alpine\n  # snowdreamtech/gserver:debian
\n

License

\n
(The MIT License)\n\nCopyright (c) 2023-present SnowdreamTech Inc.\n\nPermission is hereby granted, free of charge, to any person obtaining\na copy of this software and associated documentation files (the\n'Software'), to deal in the Software without restriction, including\nwithout limitation the rights to use, copy, modify, merge, publish,\ndistribute, sublicense, and/or sell copies of the Software, and to\npermit persons to whom the Software is furnished to do so, subject to\nthe following conditions:\n\nThe above copyright notice and this permission notice shall be\nincluded in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,\nEXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF\nMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.\nIN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY\nCLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,\nTORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE\nSOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
","updatedAt":"2025-05-21T16:00:56Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"命令行工具","color":"e05879"}},{"node":{"name":"snowdreamtech","color":"7e7645"}}]},"comments":{"edges":[]}}},"pageContext":{"number":214,"previous":{"title":"tomnomnom/gron: 将 JSON 转换为离散的值，以使其更易于根据需要进行 grep 并查看其绝对路径","number":213},"next":{"title":"madneal/gshark: 根据关键字等规则，从 GitHub、GitLab 等扫描代码泄露、敏感信息泄露等安全问题","number":215}}}, "staticQueryHashes": ["151096407","2861350382"]}