{"id":39594976,"url":"https://github.com/guilhermerodrigues680/gouploadserver","last_synced_at":"2026-01-18T07:47:35.264Z","repository":{"id":57577277,"uuid":"358339094","full_name":"guilhermerodrigues680/gouploadserver","owner":"guilhermerodrigues680","description":"O GO Upload Server foi escrito para ser agil e permitir a inicialização rápida de um servidor de arquivos a partir de um diretório.","archived":false,"fork":false,"pushed_at":"2022-10-24T19:02:18.000Z","size":546,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T12:44:35.465Z","etag":null,"topics":["golang","html","server","static","upload"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/guilhermerodrigues680.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-15T17:23:26.000Z","updated_at":"2024-06-20T12:44:35.466Z","dependencies_parsed_at":"2022-09-12T00:00:21.542Z","dependency_job_id":null,"html_url":"https://github.com/guilhermerodrigues680/gouploadserver","commit_stats":null,"previous_names":["guilhermerodrigues680/go-upload-server"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/guilhermerodrigues680/gouploadserver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilhermerodrigues680%2Fgouploadserver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilhermerodrigues680%2Fgouploadserver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilhermerodrigues680%2Fgouploadserver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilhermerodrigues680%2Fgouploadserver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/guilhermerodrigues680","download_url":"https://codeload.github.com/guilhermerodrigues680/gouploadserver/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/guilhermerodrigues680%2Fgouploadserver/sbom","scorecard":{"id":448647,"data":{"date":"2025-08-11","repo":{"name":"github.com/guilhermerodrigues680/gouploadserver","commit":"c03111984034540e1add2976fb8aa7d2d4d4a78e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":1.4,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.0.0-0 not signed: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/80781525","Warn: release artifact v0.0.2-alpha.0 not signed: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41781766","Warn: release artifact v0.0.1 not signed: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41747458","Warn: release artifact v0.0.0-alpha.0-20210418211538 not signed: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41636171","Warn: release artifact v1.0.0-0 does not have provenance: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/80781525","Warn: release artifact v0.0.2-alpha.0 does not have provenance: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41781766","Warn: release artifact v0.0.1 does not have provenance: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41747458","Warn: release artifact v0.0.0-alpha.0-20210418211538 does not have provenance: https://api.github.com/repos/guilhermerodrigues680/gouploadserver/releases/41636171"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: containerImage not pinned by hash: Dockerfile:1: pin your Docker image by updating ubuntu:20.04 to ubuntu:20.04@sha256:8feb4d8ca5354def3d8fce243717141ce31e2c428701f6682bd2fafe15388214","Info:   0 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'","Warn: branch protection not enabled for branch 'develop'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":0,"reason":"81 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-whgm-jr23-g3j9","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25","Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-x9w5-v3q2-3rhw","Warn: Project is vulnerable to: GHSA-w8qv-6jwh-64r5","Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-3wcq-x3mq-6r9p","Warn: Project is vulnerable to: GHSA-phwq-j96m-2c2q","Warn: Project is vulnerable to: GHSA-ghr5-ch3p-vcr6","Warn: Project is vulnerable to: GHSA-434g-2637-qmqr","Warn: Project is vulnerable to: GHSA-49q7-c7j4-3p7m","Warn: Project is vulnerable to: GHSA-977x-g7h5-7qgw","Warn: Project is vulnerable to: GHSA-f7q4-pwc6-w24p","Warn: Project is vulnerable to: GHSA-fc9h-whq2-v747","Warn: Project is vulnerable to: GHSA-vjh7-7g9h-fjfh","Warn: Project is vulnerable to: GHSA-6h5x-7c5m-7cr7","Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc","Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx","Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q","Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c","Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc","Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-pfq8-rq6v-vf5m","Warn: Project is vulnerable to: GHSA-c7qv-q95q-8v27","Warn: Project is vulnerable to: GHSA-78xj-cgh5-2h22","Warn: Project is vulnerable to: GHSA-2p57-rm9w-gvfp","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-76p3-8jx3-jpfq","Warn: Project is vulnerable to: GHSA-3rfm-jhwj-7488","Warn: Project is vulnerable to: GHSA-hhq3-ff78-jv3g","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-5rrq-pxf6-6jx5","Warn: Project is vulnerable to: GHSA-8fr3-hfg3-gpgp","Warn: Project is vulnerable to: GHSA-gf8q-jrpm-jvxq","Warn: Project is vulnerable to: GHSA-2r2c-g63r-vccr","Warn: Project is vulnerable to: GHSA-cfm4-qjh2-4765","Warn: Project is vulnerable to: GHSA-x4jg-mjrx-434g","Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr","Warn: Project is vulnerable to: GHSA-76c9-3jph-rj3q","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w","Warn: Project is vulnerable to: GHSA-h7cp-r72f-jxh6","Warn: Project is vulnerable to: GHSA-v62p-rq8g-8h59","Warn: Project is vulnerable to: GHSA-566m-qj78-rww5","Warn: Project is vulnerable to: GHSA-hwj9-h5mp-3pm3","Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg","Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p","Warn: Project is vulnerable to: GHSA-g4rg-993r-mgx7","Warn: Project is vulnerable to: GHSA-vx3p-948g-6vhq","Warn: Project is vulnerable to: GHSA-4wf5-vphf-c2xc","Warn: Project is vulnerable to: GHSA-52f5-9888-hmc6","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-hh27-ffr2-f2jc","Warn: Project is vulnerable to: GHSA-rqff-837h-mm52","Warn: Project is vulnerable to: GHSA-8v38-pw62-9cw2","Warn: Project is vulnerable to: GHSA-hgjh-723h-mx2j","Warn: Project is vulnerable to: GHSA-jf5r-8hm2-f872","Warn: Project is vulnerable to: GHSA-5j4c-8p2g-v4jx","Warn: Project is vulnerable to: GHSA-g3ch-rx76-35fx","Warn: Project is vulnerable to: GHSA-wr3j-pwj9-hqq6","Warn: Project is vulnerable to: GHSA-4v9v-hfq4-rm2v","Warn: Project is vulnerable to: GHSA-9jgg-88mc-972h","Warn: Project is vulnerable to: GHSA-j8xg-fqg3-53r7","Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T07:35:09.342Z","repository_id":57577277,"created_at":"2025-08-19T07:35:09.342Z","updated_at":"2025-08-19T07:35:09.342Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28533172,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","html","server","static","upload"],"created_at":"2026-01-18T07:47:35.094Z","updated_at":"2026-01-18T07:47:35.232Z","avatar_url":"https://github.com/guilhermerodrigues680.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GO Upload Server - Command Line Tool\n[![Go Reference](https://pkg.go.dev/badge/github.com/guilhermerodrigues680/gouploadserver.svg)](https://pkg.go.dev/github.com/guilhermerodrigues680/gouploadserver)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](./LICENSE)\n\nO **GO Upload Server** foi escrito para ser agil e permitir a inicialização rápida de um servidor de arquivos a partir de um diretório.\n\nEle faz leitura e escrita usando buffers o que faz ele consumir pouquissima memoria (small memory footprint).\n\n*Nota: Embora **GO Upload Server** seja uma ótima maneira de servir facilmente arquivos de um diretório, ele não deve ser usado em um ambiente de produção pois ele não implementa verificações de segurança.*\n\n## Motivações para o projeto\nServidores da web amplamente usados, como NGINX, Apache e Tomcat, são excelentes porém consomem muito tempo para serem configurados.\n\nO GO possui o package `http` com a `func FileServer` que inicia um servidor de arquivos a partir de um diretório, porém o `FileServer` não permite customizações. Ex: Alteração no template HTML padrão e CSS personalizado.\n\nEntão para ter um servidor personalizável, com novas funcionalidades e agil este projeto foi desenvolvido como uma Command Line Tool.\n\n## Features\n- Servidor de arquivos.\n- Servidor websites pois implementa  MIME types.\n- Possui o modo Servidor de Single Page Aplications (SPA) que implementa o catch-all fallback para `/index.html`.\n- Baixíssimo consumo de memória.\n- Alteração fácil da porta do servidor via flag\n- Navegador de arquivos com opção para upload de arquivo no diretório navegado.\n- Implementa o renomeio dos arquivos enviados para não sobreescrever os arquivos originais do diretório (pode ser desativado via flag).\n- Usa o Go templates internamente permitindo a customização do navegador de arquivos.\n\n## Instalação\n### Instalação com Go (requer v1.16+).\n\n```console\ngo get -u guilhermerodrigues680/gouploadserver\n```\n\n### Instalação com binários pré-compilados (qualquer sistema operacional) \nPara instalar a versão mais recente do gouploadserver a partir de binários pré-compilados, siga estas instruções:\n\n1. Baixe manualmente em [github.com/guilhermerodrigues680/gouploadserver/releases](https://github.com/guilhermerodrigues680/gouploadserver/releases) o arquivo zip correspondente ao seu sistema operacional e arquitetura do computador (`gouploadserver-\u003cversion\u003e-\u003cos\u003e\u003carch\u003e.zip`), ou baixe o arquivo usando comandos como os seguintes:\n\n```sh\n$ PR_REL=\"https://github.com/guilhermerodrigues680/gouploadserver/releases\"\n$ curl -LO $PR_REL/download/v1.0.0/gouploadserver-v1.0.0-linux-amd64.zip\n```\n\n2. Descompacte o arquivo em `$HOME/.local` ou em um diretório de sua escolha. Por exemplo:\n\n```sh\n$ unzip gouploadserver-v1.0.0-linux-amd64.zip -d $HOME/.local\n```\n\n3. Atualize os seu `PATH` para incluir o caminho para o executável gouploadserver. Por exemplo: \n\n```sh\n$ export PATH=\"$PATH:$HOME/.local/bin\"\n```\n\n## Como usar\n\nStart do **gouploadserver** com as configurações padrão:\n\n```console\n$ gouploadserver\n```\n\nÉ possivel passar flags para o **gouploadserver**:\n\n```sh\n# Usage: gouploadserver [options] [path]\n$ gouploadserver --port 8082 ./folder\n```\n\n### Command-Line Options\n```console\nUsage: gouploadserver [options] [path]\n[path] defaults to ./\nOptions are:\n  --dev                      Use development settings (default false)\n  --keep-upload-filename     Keep original upload file name: Use 'filename.ext' instead of 'filename\u003c-random\u003e.ext' (default false)\n  --port                     Port to use (default 8000)\n  --spa                      Return to all files not found /index.html (default false)\n  --version                  Show version number and quit (default false)\n  --watch-mem                Watch memory usage (default false)\n  --help                     Display usage information (this message)\n  -h                         Display usage information (this message) (shorthand)\n```\n\n## Configuração do projeto para desenvolvimento\n\n**\\* Requer o GO v1.16+**\n\n```sh\n$ git clone https://github.com/guilhermerodrigues680/gouploadserver.git\n```\n\nO Makefile possui intruções para compilar o projeto:\n\n```sh\n# make build compila para diversas plataformas\nmake build\n\n# output bin/gouploadserver-\u003cversion\u003e-\u003cos\u003e\u003carch\u003e\n```\n\n```sh\n# make cross compila somente para plataforma atual\nmake cross\n\n# output bin/gouploadserver\n```\n\n### Instalação a partir do código do projeto\n\n```sh\nmake install\n# ou\ngo install\n\n# output: $GOPATH/bin/gouploadserver\n```\n\n## Versionamento\n\nEste projeto segue o [Versionamento Semântico 2.0.0](https://semver.org/lang/pt-BR/spec/v2.0.0.html).\n\n\u003c!-- ## Changelog --\u003e\n\u003c!-- https://keepachangelog.com/en/1.0.0/ --\u003e\n\n## Licença\nEste projeto está licenciado sob os termos da licença MIT. Veja [LICENSE](./LICENSE).\n\n## Anotações\n\n\u003cdetails\u003e\n\u003csummary\u003eAnotações\u003c/summary\u003e\n\u003cbr\u003e\n- https://www.digitalocean.com/community/tutorials/how-to-build-and-install-go-programs-pt\n- https://golang.org/doc/tutorial/compile-install\n- https://golang.org/ref/mod#go-install\n- https://makefiletutorial.com/\n\n```sh\n➜  cmd go list -f '{{.Target}}'\n/Users/guilherme/go/bin/cmd\n```\n\n```sh\ngo test -v -benchmem -bench=.\n```\ndate -u +\"%Y%m%d%H%M%S\"\nTZ=UTC date +\"%Y%m%d%H%M%S\"\nTZ=GMT date +\"%Y%m%d%H%M%S\"\n\nhttps://pkg.go.dev/github.com/guilhermerodrigues680/gouploadserver\n\ngit tag v0.0.0-alpha.0-$(date -u +\"%Y%m%d%H%M%S\")\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilhermerodrigues680%2Fgouploadserver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguilhermerodrigues680%2Fgouploadserver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguilhermerodrigues680%2Fgouploadserver/lists"}