A FTP server framework written by Golang
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
Lunny Xiao 72a57b1868
remove unused go sum
pirms 3 mēnešiem
exampleftpd update projects new package name pirms 4 mēnešiem
.drone.yml add drone support (#74) pirms 4 mēnešiem
.gitignore update projects new package name pirms 4 mēnešiem
LICENSE release v0.3.0 pirms 1 gada
README.md update projects new package name pirms 4 mēnešiem
auth.go Use constant-time compare for SimpleAuth (#68) pirms 4 mēnešiem
cmd.go added LPRT command (#48) pirms 4 mēnešiem
cmd_test.go release v0.3.0 pirms 1 gada
conn.go Update conn.go (#77) pirms 4 mēnešiem
conn_test.go Fix for `passiveListenIP`. Currently the function returns different (#70) pirms 4 mēnešiem
doc.go release v0.3.0 pirms 1 gada
driver.go release v0.3.0 pirms 1 gada
fileinfo.go release v0.3.0 pirms 1 gada
go.mod remove unused go sum pirms 3 mēnešiem
go.sum remove unused go sum pirms 3 mēnešiem
listformatter.go :bug: Fixes the problem of integer overflow when file size is too large (#43) pirms 1 gada
logger.go Improve shutdown behaviour (#42) pirms 1 gada
perm.go release v0.3.0 pirms 1 gada
server.go fix feats command bug (#53) pirms 1 gada
server_test.go update projects new package name pirms 4 mēnešiem
socket.go Fix socket leak for never used PASV connections (#62) pirms 10 mēnešiem

README.md

server

Build Status

A FTP server framework forked from github.com/yob/graval and changed a lot.

Full documentation for the package is available on godoc

Version

v0.2.3

Installation

go get goftp.io/server

Usage

To boot a FTP server you will need to provide a driver that speaks to your persistence layer - the required driver contract is in the documentation.

Look at the file driver to see an example of how to build a backend.

There is a sample ftp server as a demo. You can build it with this command:

go install goftp.io/server/exampleftpd

Then run it if you have add $GOPATH to your $PATH:

exampleftpd -root /tmp

And finally, connect to the server with any FTP client and the following details:

host: 127.0.0.1
port: 2121
username: admin
password: 123456

This uses the file driver mentioned above to serve files.

Contributors

see https://gitea.com/goftp/server/graphs/contributors

Warning

FTP is an incredibly insecure protocol. Be careful about forcing users to authenticate with an username or password that are important.

License

This library is distributed under the terms of the MIT License. See the included file for more detail.

Contributing

All suggestions and patches welcome, preferably via a git repository I can pull from. If this library proves useful to you, please let me know.

Further Reading

There are a range of RFCs that together specify the FTP protocol. In chronological order, the more useful ones are:

For an english summary that’s somewhat more legible than the RFCs, and provides some commentary on what features are actually useful or relevant 24 years after RFC959 was published:

For a history lesson, check out Appendix III of RCF959. It lists the preceding (obsolete) RFC documents that relate to file transfers, including the ye old RFC114 from 1971, “A File Transfer Protocol”

This library is heavily based on em-ftpd, an FTPd framework with similar design goals within the ruby and EventMachine ecosystems. It worked well enough, but you know, callbacks and event loops make me something something.