原文链接:https://github.com/Dream4ever...
项目简介
tus/tusd,这是项目官网,该项目是一个后端服务,用于接收从前端页面所上传的文件。搭配前端 JS 库 transloadit/uppy,即可实现完整的文件上传功能。
tusd 这个库的一大亮点,是可以实现文件的断点续传。
项目克隆
需已在 Windows 上安装 Go
进入 $GOPATH\src
目录,$GOPATH
通常位于 C:\Users\XXX\go
。如果没有的话,就新建对应目录,路径里的 XXX
是当前用户名。
执行下面的命令,将项目克隆至当前目录中。
git clone github.com/tus/tusd
第一个坑:注意上面的克隆地址和 GitHub 官网给出的不一样,如果用的是官网给出的地址 git@github.com:tus/tusd.git
,会报下面的错误:
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
安装依赖
执行下面两条命令,下载并安装 tusd 所需的依赖。
go get -u github.com/aws/aws-sdk-go/
go get -u github.com/prometheus/client_golang/prometheus
第二个坑:为保证依赖能够正常下载,请参照 解决 go get 太慢的问题 一文中所说的方法,配置 GOPROXY
参数,并在终端开启代理。
经实际测试,在配置了 GOPROXY
并在终端开启代理之后,第一个依赖 aws-sdk-go
可正常下载编译。
第三个坑:即使配置了 GOPROXY
并在终端开启代理,安装第二个依赖 prometheus
的时候还是会报错。这里并不是说所做的设置出了问题,而是因为这个依赖需要从 golang.org/x
这个网站上下载包。奇怪的是,在终端所开启的代理对 GitHub 有效,对这个网站就无效,所以才有了这个坑。
既然如此,就只能曲线救国了,按照 解决 go get 太慢的问题 一文中所说的另一个方法,去 golang 在 GitHub 上的镜像项目里下载对应的包。
比如在安装第二个依赖 prometheus
的时候,给出了下面的提示,意思就是没能下载到 sys/windows
这个包。
package golang.org/x/sys/windows: unrecognized import path "golang.org/x/sys/windows" (https fetch: Get https://golang.org/x/sys/windows?go-get=1: dial tcp 216.239.37.1:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.)
那就去 golang 在 GitHub 上面的网站看看,可以找到 sys/windows 这个包,先把它下载过来:
go get -u github.com/golang/sys/windows
上面的命令会把 sys/windows
这个包下载到 $GOPATH\src\github.com\golang\sys
目录下,而前面安装依赖 prometheus
的时候,所提到的包的名称是 golang.org/x/sys/windows
,那就需要把刚下载过来的这个包放到提示信息中所说的目录下面。
为了省事,直接把 $GOPATH\src\github.com\golang\sys
这个文件夹,复制到 $GOPATH\src\golang.org\x
下面。
这个时候,再执行一遍下面的命令,继续安装第二个依赖。
go get -u github.com/prometheus/client_golang/prometheus
这次的安装之所以能成功,是因为 go get -u
中的 -u
参数,对于已经下载到本地的包,不会重复下载,这样前面手动把 sys/windws
这个包下载过来了,所以这次安装第二个依赖的时候,就能直接使用已经下载过来的这个包了。
编译项目
执行下面的命令,开始编译生成 tusd 对应的可执行文件。
cd $GOPATH\src\tusd
go build -o tusd.exe cmd/tusd/main.go
第四个坑:执行 go build
命令之后,会再次报错:
cmd\tusd\main.go:4:2: cannot find package "github.com/tus/tusd/cmd/tusd/cli" in any of:
C:\Users\Administrator\go\src\tusd\vendor\github.com\tus\tusd\cmd\tusd\cli (vendor tree)
c:\go\src\github.com\tus\tusd\cmd\tusd\cli (from $GOROOT)
C:\Users\Administrator\go\src\github.com\tus\tusd\cmd\tusd\cli (from $GOPATH)
上网查了查,原来有人已经遇到过这个问题了,说是再手动安装一下 github.com/tus/tusd/cmd/tusd/cli
这个包就行。好吧,那就执行下面的命令,手动安装一下这个包:
go get -u github.com/tus/tusd/cmd/tusd/cli
安装完所需的包之后,再次执行下面的命令,编译代码:
go build -o tusd.exe cmd/tusd/main.go
第五个坑:这回终于能够成功编译了,不过这里的命令和官网的还是有点不一样。go build
命令的 -o
参数后面必须指定文件名,在 Unix/Linux 系统里,可执行文件是没有扩展名的,但是在 Windows 上就不一样了,通常是 .exe
,而 go build
命令的 -o
参数是按照 Unix/Linux 的习惯来的,所以在 Windows 下使用 go build -o abc
这样的命令来编译的话,是不会自动加上 .exe
这个扩展名的,需要明确写上扩展名才可以。
项目运行
执行下面的命令,即可将 tusd 运行在指定的 IP 和端口上:
.\tusd.exe -host 127.0.0.1 -port 1088
参考资料
- Are there "always on" module repositories and enterprise proxies?:列表中包含国内的几个 Go 镜像站。
- 无法安装 golang.org/x/tools/的库:golang.org/x 或者 go.googlesource.com 上面的包无法下载的话,都可以用这个曲线救国的办法,去 GitHub 上找对应的镜像项目下过来,然后放到这个包在 golang.org/x 或者 go.googlesource.com 上的对应位置下。
-
Compile from source on MacOS:明明是这个项目里的包,却还是报错,就因为路径不对,也是够坑的。用
git clone
就是把当前项目下载到当前路径,比如本项目tusd
,就是下载到当前目录的tusd
文件夹下。用go get
则是把当前项目下载到相对路径下,比如本项目就是下载到$GOPATH\src\github.com\tus\tusd
这个路径下。等等,如果我最开始不是克隆项目,而是用go get
来下载安装这个项目的话,是不是会省事很多?大坑啊! -
go build: Compile packages and dependencies:看了官方文档,才知道
go build
的-o
参数在 Windows 下,不会自动附加可执行文件的.exe
扩展名。
有疑问加站长微信联系(非本文作者)