24 "golang.org/x/crypto/bcrypt"
29 userIdleSeconds = 300 // time in seconds before an inactive user is marked idle
30 idleCheckInterval = 10 // time in seconds to check for idle users
31 trackerUpdateFrequency = 300 // time in seconds between tracker re-registration
36 Accounts map[string]*Account
38 Clients map[uint16]*ClientConn
40 ThreadedNews *ThreadedNews
41 FileTransfers map[uint32]*FileTransfer
44 Logger *zap.SugaredLogger
45 PrivateChats map[uint32]*PrivateChat
50 APIListener net.Listener
51 FileListener net.Listener
54 newsWriter io.WriteCloser
56 outbox chan Transaction
59 flatNewsMux sync.Mutex
62 type PrivateChat struct {
64 ClientConn map[uint16]*ClientConn
67 func (s *Server) ListenAndServe(ctx context.Context, cancelRoot context.CancelFunc) error {
68 s.Logger.Infow("Hotline server started", "version", VERSION)
72 go func() { s.Logger.Fatal(s.Serve(ctx, cancelRoot, s.APIListener)) }()
75 go func() { s.Logger.Fatal(s.ServeFileTransfers(s.FileListener)) }()
82 func (s *Server) APIPort() int {
83 return s.APIListener.Addr().(*net.TCPAddr).Port
86 func (s *Server) ServeFileTransfers(ln net.Listener) error {
87 s.Logger.Infow("Hotline file transfer server started", "Addr", fmt.Sprintf(":%v", s.Port+1))
90 conn, err := ln.Accept()
96 if err := s.TransferFile(conn); err != nil {
97 s.Logger.Errorw("file transfer error", "reason", err)
103 func (s *Server) sendTransaction(t Transaction) error {
104 requestNum := binary.BigEndian.Uint16(t.Type)
105 clientID, err := byteToInt(*t.clientID)
111 client := s.Clients[uint16(clientID)]
114 return errors.New("invalid client")
116 userName := string(client.UserName)
117 login := client.Account.Login
119 handler := TransactionHandlers[requestNum]
121 b, err := t.MarshalBinary()
126 if n, err = client.Connection.Write(b); err != nil {
129 s.Logger.Debugw("Sent Transaction",
132 "IsReply", t.IsReply,
133 "type", handler.Name,
135 "remoteAddr", client.Connection.RemoteAddr(),
140 func (s *Server) Serve(ctx context.Context, cancelRoot context.CancelFunc, ln net.Listener) error {
141 s.Logger.Infow("Hotline server started", "Addr", fmt.Sprintf(":%v", s.Port))
144 conn, err := ln.Accept()
146 s.Logger.Errorw("error accepting connection", "err", err)
153 if err := s.sendTransaction(t); err != nil {
154 s.Logger.Errorw("error sending transaction", "err", err)
160 if err := s.handleNewConnection(conn); err != nil {
162 s.Logger.Infow("Client disconnected", "RemoteAddr", conn.RemoteAddr())
164 s.Logger.Errorw("error serving request", "RemoteAddr", conn.RemoteAddr(), "err", err)
172 agreementFile = "Agreement.txt"
175 // NewServer constructs a new Server from a config dir
176 func NewServer(configDir, netInterface string, netPort int, logger *zap.SugaredLogger) (*Server, error) {
179 Accounts: make(map[string]*Account),
181 Clients: make(map[uint16]*ClientConn),
182 FileTransfers: make(map[uint32]*FileTransfer),
183 PrivateChats: make(map[uint32]*PrivateChat),
184 ConfigDir: configDir,
186 NextGuestID: new(uint16),
187 outbox: make(chan Transaction),
188 Stats: &Stats{StartTime: time.Now()},
189 ThreadedNews: &ThreadedNews{},
190 TrackerPassID: make([]byte, 4),
193 ln, err := net.Listen("tcp", fmt.Sprintf("%s:%v", netInterface, netPort))
197 server.APIListener = ln
203 ln2, err := net.Listen("tcp", fmt.Sprintf("%s:%v", netInterface, netPort))
204 server.FileListener = ln2
209 // generate a new random passID for tracker registration
210 if _, err := rand.Read(server.TrackerPassID); err != nil {
214 server.Logger.Debugw("Loading Agreement", "path", configDir+agreementFile)
215 if server.Agreement, err = os.ReadFile(configDir + agreementFile); err != nil {
219 if server.FlatNews, err = os.ReadFile(configDir + "MessageBoard.txt"); err != nil {
223 if err := server.loadThreadedNews(configDir + "ThreadedNews.yaml"); err != nil {
227 if err := server.loadConfig(configDir + "config.yaml"); err != nil {
231 if err := server.loadAccounts(configDir + "Users/"); err != nil {
235 server.Config.FileRoot = configDir + "Files/"
237 *server.NextGuestID = 1
239 if server.Config.EnableTrackerRegistration {
242 tr := TrackerRegistration{
243 Port: []byte{0x15, 0x7c},
244 UserCount: server.userCount(),
245 PassID: server.TrackerPassID,
246 Name: server.Config.Name,
247 Description: server.Config.Description,
249 for _, t := range server.Config.Trackers {
250 server.Logger.Infof("Registering with tracker %v", t)
252 if err := register(t, tr); err != nil {
253 server.Logger.Errorw("unable to register with tracker %v", "error", err)
257 time.Sleep(trackerUpdateFrequency * time.Second)
262 // Start Client Keepalive go routine
263 go server.keepaliveHandler()
268 func (s *Server) userCount() int {
272 return len(s.Clients)
275 func (s *Server) keepaliveHandler() {
277 time.Sleep(idleCheckInterval * time.Second)
280 for _, c := range s.Clients {
281 *c.IdleTime += idleCheckInterval
282 if *c.IdleTime > userIdleSeconds && !c.Idle {
285 flagBitmap := big.NewInt(int64(binary.BigEndian.Uint16(*c.Flags)))
286 flagBitmap.SetBit(flagBitmap, userFlagAway, 1)
287 binary.BigEndian.PutUint16(*c.Flags, uint16(flagBitmap.Int64()))
290 tranNotifyChangeUser,
291 NewField(fieldUserID, *c.ID),
292 NewField(fieldUserFlags, *c.Flags),
293 NewField(fieldUserName, c.UserName),
294 NewField(fieldUserIconID, *c.Icon),
302 func (s *Server) writeThreadedNews() error {
306 out, err := yaml.Marshal(s.ThreadedNews)
310 err = ioutil.WriteFile(
311 s.ConfigDir+"ThreadedNews.yaml",
318 func (s *Server) NewClientConn(conn net.Conn) *ClientConn {
322 clientConn := &ClientConn{
325 Flags: &[]byte{0, 0},
331 AutoReply: &[]byte{},
332 Transfers: make(map[int][]*FileTransfer),
337 *clientConn.IdleTime = 0
339 binary.BigEndian.PutUint16(*clientConn.ID, ID)
340 s.Clients[ID] = clientConn
345 // NewUser creates a new user account entry in the server map and config file
346 func (s *Server) NewUser(login, name, password string, access []byte) error {
353 Password: hashAndSalt([]byte(password)),
356 out, err := yaml.Marshal(&account)
360 s.Accounts[login] = &account
362 return ioutil.WriteFile(s.ConfigDir+"Users/"+login+".yaml", out, 0666)
365 // DeleteUser deletes the user account
366 func (s *Server) DeleteUser(login string) error {
370 delete(s.Accounts, login)
372 return os.Remove(s.ConfigDir + "Users/" + login + ".yaml")
375 func (s *Server) connectedUsers() []Field {
379 var connectedUsers []Field
380 for _, c := range s.Clients {
385 Name: string(c.UserName),
387 connectedUsers = append(connectedUsers, NewField(fieldUsernameWithInfo, user.Payload()))
389 return connectedUsers
392 // loadThreadedNews loads the threaded news data from disk
393 func (s *Server) loadThreadedNews(threadedNewsPath string) error {
394 fh, err := os.Open(threadedNewsPath)
398 decoder := yaml.NewDecoder(fh)
399 decoder.SetStrict(true)
401 return decoder.Decode(s.ThreadedNews)
404 // loadAccounts loads account data from disk
405 func (s *Server) loadAccounts(userDir string) error {
406 matches, err := filepath.Glob(path.Join(userDir, "*.yaml"))
411 if len(matches) == 0 {
412 return errors.New("no user accounts found in " + userDir)
415 for _, file := range matches {
416 fh, err := FS.Open(file)
422 decoder := yaml.NewDecoder(fh)
423 decoder.SetStrict(true)
424 if err := decoder.Decode(&account); err != nil {
428 s.Accounts[account.Login] = &account
433 func (s *Server) loadConfig(path string) error {
434 fh, err := FS.Open(path)
439 decoder := yaml.NewDecoder(fh)
440 decoder.SetStrict(true)
441 err = decoder.Decode(s.Config)
449 minTransactionLen = 22 // minimum length of any transaction
452 // handleNewConnection takes a new net.Conn and performs the initial login sequence
453 func (s *Server) handleNewConnection(conn net.Conn) error {
454 handshakeBuf := make([]byte, 12) // handshakes are always 12 bytes in length
455 if _, err := conn.Read(handshakeBuf); err != nil {
458 if err := Handshake(conn, handshakeBuf[:12]); err != nil {
462 buf := make([]byte, 1024)
463 readLen, err := conn.Read(buf)
464 if readLen < minTransactionLen {
471 clientLogin, _, err := ReadTransaction(buf[:readLen])
476 c := s.NewClientConn(conn)
479 if r := recover(); r != nil {
480 fmt.Println("stacktrace from panic: \n" + string(debug.Stack()))
481 c.Server.Logger.Errorw("PANIC", "err", r, "trace", string(debug.Stack()))
486 encodedLogin := clientLogin.GetField(fieldUserLogin).Data
487 encodedPassword := clientLogin.GetField(fieldUserPassword).Data
488 *c.Version = clientLogin.GetField(fieldVersion).Data
491 for _, char := range encodedLogin {
492 login += string(rune(255 - uint(char)))
498 // If authentication fails, send error reply and close connection
499 if !c.Authenticate(login, encodedPassword) {
500 t := c.NewErrReply(clientLogin, "Incorrect login.")
501 b, err := t.MarshalBinary()
505 if _, err := conn.Write(b); err != nil {
508 return fmt.Errorf("incorrect login")
511 if clientLogin.GetField(fieldUserName).Data != nil {
512 c.UserName = clientLogin.GetField(fieldUserName).Data
515 if clientLogin.GetField(fieldUserIconID).Data != nil {
516 *c.Icon = clientLogin.GetField(fieldUserIconID).Data
519 c.Account = c.Server.Accounts[login]
521 if c.Authorize(accessDisconUser) {
522 *c.Flags = []byte{0, 2}
525 s.Logger.Infow("Client connection received", "login", login, "version", *c.Version, "RemoteAddr", conn.RemoteAddr().String())
527 s.outbox <- c.NewReply(clientLogin,
528 NewField(fieldVersion, []byte{0x00, 0xbe}),
529 NewField(fieldCommunityBannerID, []byte{0x00, 0x01}),
530 NewField(fieldServerName, []byte(s.Config.Name)),
533 // Send user access privs so client UI knows how to behave
534 c.Server.outbox <- *NewTransaction(tranUserAccess, c.ID, NewField(fieldUserAccess, *c.Account.Access))
536 // Show agreement to client
537 c.Server.outbox <- *NewTransaction(tranShowAgreement, c.ID, NewField(fieldData, s.Agreement))
539 if _, err := c.notifyNewUserHasJoined(); err != nil {
542 c.Server.Stats.LoginCount += 1
544 const readBuffSize = 1024000 // 1KB - TODO: what should this be?
545 tranBuff := make([]byte, 0)
547 // Infinite loop where take action on incoming client requests until the connection is closed
549 buf = make([]byte, readBuffSize)
550 tranBuff = tranBuff[tReadlen:]
552 readLen, err := c.Connection.Read(buf)
556 tranBuff = append(tranBuff, buf[:readLen]...)
558 // We may have read multiple requests worth of bytes from Connection.Read. readTransactions splits them
559 // into a slice of transactions
560 var transactions []Transaction
561 if transactions, tReadlen, err = readTransactions(tranBuff); err != nil {
562 c.Server.Logger.Errorw("Error handling transaction", "err", err)
565 // iterate over all of the transactions that were parsed from the byte slice and handle them
566 for _, t := range transactions {
567 if err := c.handleTransaction(&t); err != nil {
568 c.Server.Logger.Errorw("Error handling transaction", "err", err)
574 func hashAndSalt(pwd []byte) string {
575 // Use GenerateFromPassword to hash & salt pwd.
576 // MinCost is just an integer constant provided by the bcrypt
577 // package along with DefaultCost & MaxCost.
578 // The cost can be any value you want provided it isn't lower
579 // than the MinCost (4)
580 hash, err := bcrypt.GenerateFromPassword(pwd, bcrypt.MinCost)
584 // GenerateFromPassword returns a byte slice so we need to
585 // convert the bytes to a string and return it
589 // NewTransactionRef generates a random ID for the file transfer. The Hotline client includes this ID
590 // in the file transfer request payload, and the file transfer server will use it to map the request
592 func (s *Server) NewTransactionRef() []byte {
593 transactionRef := make([]byte, 4)
594 rand.Read(transactionRef)
596 return transactionRef
599 func (s *Server) NewPrivateChat(cc *ClientConn) []byte {
603 randID := make([]byte, 4)
605 data := binary.BigEndian.Uint32(randID[:])
607 s.PrivateChats[data] = &PrivateChat{
609 ClientConn: make(map[uint16]*ClientConn),
611 s.PrivateChats[data].ClientConn[cc.uint16ID()] = cc
616 const dlFldrActionSendFile = 1
617 const dlFldrActionResumeFile = 2
618 const dlFldrActionNextFile = 3
620 func (s *Server) TransferFile(conn net.Conn) error {
621 defer func() { _ = conn.Close() }()
623 buf := make([]byte, 1024)
624 if _, err := conn.Read(buf); err != nil {
629 _, err := t.Write(buf[:16])
634 transferRefNum := binary.BigEndian.Uint32(t.ReferenceNumber[:])
635 fileTransfer := s.FileTransfers[transferRefNum]
637 switch fileTransfer.Type {
639 fullFilePath, err := readPath(s.Config.FileRoot, fileTransfer.FilePath, fileTransfer.FileName)
644 ffo, err := NewFlattenedFileObject(
646 fileTransfer.FilePath,
647 fileTransfer.FileName,
653 s.Logger.Infow("File download started", "filePath", fullFilePath, "transactionRef", fileTransfer.ReferenceNumber, "RemoteAddr", conn.RemoteAddr().String())
655 // Start by sending flat file object to client
656 if _, err := conn.Write(ffo.BinaryMarshal()); err != nil {
660 file, err := FS.Open(fullFilePath)
665 sendBuffer := make([]byte, 1048576)
668 if bytesRead, err = file.Read(sendBuffer); err == io.EOF {
672 fileTransfer.BytesSent += bytesRead
674 delete(s.FileTransfers, transferRefNum)
676 if _, err := conn.Write(sendBuffer[:bytesRead]); err != nil {
681 if _, err := conn.Read(buf); err != nil {
685 ffo := ReadFlattenedFileObject(buf)
686 payloadLen := len(ffo.BinaryMarshal())
687 fileSize := int(binary.BigEndian.Uint32(ffo.FlatFileDataForkHeader.DataSize))
689 destinationFile := s.Config.FileRoot + ReadFilePath(fileTransfer.FilePath) + "/" + string(fileTransfer.FileName)
691 "File upload started",
692 "transactionRef", fileTransfer.ReferenceNumber,
693 "RemoteAddr", conn.RemoteAddr().String(),
695 "dstFile", destinationFile,
698 newFile, err := os.Create(destinationFile)
703 defer func() { _ = newFile.Close() }()
705 const buffSize = 1024
707 if _, err := newFile.Write(buf[payloadLen:]); err != nil {
710 receivedBytes := buffSize - payloadLen
713 if (fileSize - receivedBytes) < buffSize {
715 "File upload complete",
716 "transactionRef", fileTransfer.ReferenceNumber,
717 "RemoteAddr", conn.RemoteAddr().String(),
719 "dstFile", destinationFile,
722 if _, err := io.CopyN(newFile, conn, int64(fileSize-receivedBytes)); err != nil {
723 return fmt.Errorf("file transfer failed: %s", err)
728 // Copy N bytes from conn to upload file
729 n, err := io.CopyN(newFile, conn, buffSize)
733 receivedBytes += int(n)
736 // Folder Download flow:
737 // 1. Get filePath from the transfer
738 // 2. Iterate over files
740 // Send file header to client
741 // The client can reply in 3 ways:
743 // 1. If type is an odd number (unknown type?), or file download for the current file is completed:
744 // client sends []byte{0x00, 0x03} to tell the server to continue to the next file
746 // 2. If download of a file is to be resumed:
748 // []byte{0x00, 0x02} // download folder action
749 // [2]byte // Resume data size
750 // []byte file resume data (see myField_FileResumeData)
752 // 3. Otherwise download of the file is requested and client sends []byte{0x00, 0x01}
754 // When download is requested (case 2 or 3), server replies with:
755 // [4]byte - file size
756 // []byte - Flattened File Object
758 // After every file download, client could request next file with:
759 // []byte{0x00, 0x03}
761 // This notifies the server to send the next item header
763 fullFilePath, err := readPath(s.Config.FileRoot, fileTransfer.FilePath, fileTransfer.FileName)
768 basePathLen := len(fullFilePath)
770 readBuffer := make([]byte, 1024)
772 s.Logger.Infow("Start folder download", "path", fullFilePath, "ReferenceNumber", fileTransfer.ReferenceNumber, "RemoteAddr", conn.RemoteAddr())
775 _ = filepath.Walk(fullFilePath+"/", func(path string, info os.FileInfo, _ error) error {
777 subPath := path[basePathLen:]
778 s.Logger.Infow("Sending fileheader", "i", i, "path", path, "fullFilePath", fullFilePath, "subPath", subPath, "IsDir", info.IsDir())
780 fileHeader := NewFileHeader(subPath, info.IsDir())
786 // Send the file header to client
787 if _, err := conn.Write(fileHeader.Payload()); err != nil {
788 s.Logger.Errorf("error sending file header: %v", err)
792 // Read the client's Next Action request
793 //TODO: Remove hardcoded behavior and switch behaviors based on the next action send
794 if _, err := conn.Read(readBuffer); err != nil {
798 s.Logger.Infow("Client folder download action", "action", fmt.Sprintf("%X", readBuffer[0:2]))
804 splitPath := strings.Split(path, "/")
806 ffo, err := NewFlattenedFileObject(
807 strings.Join(splitPath[:len(splitPath)-1], "/"),
814 s.Logger.Infow("File download started",
815 "fileName", info.Name(),
816 "transactionRef", fileTransfer.ReferenceNumber,
817 "RemoteAddr", conn.RemoteAddr().String(),
818 "TransferSize", fmt.Sprintf("%x", ffo.TransferSize()),
821 // Send file size to client
822 if _, err := conn.Write(ffo.TransferSize()); err != nil {
827 // Send file bytes to client
828 if _, err := conn.Write(ffo.BinaryMarshal()); err != nil {
833 file, err := FS.Open(path)
838 sendBuffer := make([]byte, 1048576)
839 totalBytesSent := len(ffo.BinaryMarshal())
842 bytesRead, err := file.Read(sendBuffer)
844 // Read the client's Next Action request
845 //TODO: Remove hardcoded behavior and switch behaviors based on the next action send
846 if _, err := conn.Read(readBuffer); err != nil {
847 s.Logger.Errorf("error reading next action: %v", err)
853 sentBytes, readErr := conn.Write(sendBuffer[:bytesRead])
854 totalBytesSent += sentBytes
863 dstPath, err := readPath(s.Config.FileRoot, fileTransfer.FilePath, fileTransfer.FileName)
868 "Folder upload started",
869 "transactionRef", fileTransfer.ReferenceNumber,
870 "RemoteAddr", conn.RemoteAddr().String(),
872 "TransferSize", fmt.Sprintf("%x", fileTransfer.TransferSize),
873 "FolderItemCount", fileTransfer.FolderItemCount,
876 // Check if the target folder exists. If not, create it.
877 if _, err := FS.Stat(dstPath); os.IsNotExist(err) {
878 s.Logger.Infow("Creating target path", "dstPath", dstPath)
879 if err := FS.Mkdir(dstPath, 0777); err != nil {
884 readBuffer := make([]byte, 1024)
886 // Begin the folder upload flow by sending the "next file action" to client
887 if _, err := conn.Write([]byte{0, dlFldrActionNextFile}); err != nil {
891 fileSize := make([]byte, 4)
892 itemCount := binary.BigEndian.Uint16(fileTransfer.FolderItemCount)
894 for i := uint16(0); i < itemCount; i++ {
895 if _, err := conn.Read(readBuffer); err != nil {
898 fu := readFolderUpload(readBuffer)
901 "Folder upload continued",
902 "transactionRef", fmt.Sprintf("%x", fileTransfer.ReferenceNumber),
903 "RemoteAddr", conn.RemoteAddr().String(),
904 "FormattedPath", fu.FormattedPath(),
905 "IsFolder", fmt.Sprintf("%x", fu.IsFolder),
906 "PathItemCount", binary.BigEndian.Uint16(fu.PathItemCount[:]),
909 if fu.IsFolder == [2]byte{0, 1} {
910 if _, err := os.Stat(dstPath + "/" + fu.FormattedPath()); os.IsNotExist(err) {
911 s.Logger.Infow("Target path does not exist; Creating...", "dstPath", dstPath)
912 if err := os.Mkdir(dstPath+"/"+fu.FormattedPath(), 0777); err != nil {
917 // Tell client to send next file
918 if _, err := conn.Write([]byte{0, dlFldrActionNextFile}); err != nil {
923 // TODO: Check if we have the full file already. If so, send dlFldrAction_NextFile to client to skip.
924 // TODO: Check if we have a partial file already. If so, send dlFldrAction_ResumeFile to client to resume upload.
925 // Send dlFldrAction_SendFile to client to begin transfer
926 if _, err := conn.Write([]byte{0, dlFldrActionSendFile}); err != nil {
930 if _, err := conn.Read(fileSize); err != nil {
931 fmt.Println("Error reading:", err.Error()) // TODO: handle
934 s.Logger.Infow("Starting file transfer", "fileNum", i+1, "totalFiles", itemCount, "fileSize", fileSize)
936 if err := transferFile(conn, dstPath+"/"+fu.FormattedPath()); err != nil {
940 // Tell client to send next file
941 if _, err := conn.Write([]byte{0, dlFldrActionNextFile}); err != nil {
946 // Client sends "MACR" after the file. Read and discard.
947 // TODO: This doesn't seem to be documented. What is this? Maybe resource fork?
948 if _, err := conn.Read(readBuffer); err != nil {
953 s.Logger.Infof("Folder upload complete")
959 func transferFile(conn net.Conn, dst string) error {
960 const buffSize = 1024
961 buf := make([]byte, buffSize)
963 // Read first chunk of bytes from conn; this will be the Flat File Object and initial chunk of file bytes
964 if _, err := conn.Read(buf); err != nil {
967 ffo := ReadFlattenedFileObject(buf)
968 payloadLen := len(ffo.BinaryMarshal())
969 fileSize := int(binary.BigEndian.Uint32(ffo.FlatFileDataForkHeader.DataSize))
971 newFile, err := os.Create(dst)
975 defer func() { _ = newFile.Close() }()
976 if _, err := newFile.Write(buf[payloadLen:]); err != nil {
979 receivedBytes := buffSize - payloadLen
982 if (fileSize - receivedBytes) < buffSize {
983 _, err := io.CopyN(newFile, conn, int64(fileSize-receivedBytes))
987 // Copy N bytes from conn to upload file
988 n, err := io.CopyN(newFile, conn, buffSize)
992 receivedBytes += int(n)
997 // sortedClients is a utility function that takes a map of *ClientConn and returns a sorted slice of the values.
998 // The purpose of this is to ensure that the ordering of client connections is deterministic so that test assertions work.
999 func sortedClients(unsortedClients map[uint16]*ClientConn) (clients []*ClientConn) {
1000 for _, c := range unsortedClients {
1001 clients = append(clients, c)
1003 sort.Sort(byClientID(clients))