serve.go 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196
  1. package cmd
  2. import (
  3. "errors"
  4. "fmt"
  5. "github.com/urfave/cli/v2"
  6. "github.com/urfave/cli/v2/altsrc"
  7. "heckel.io/ntfy/server"
  8. "heckel.io/ntfy/util"
  9. "log"
  10. "math"
  11. "time"
  12. )
  13. var flagsServe = []cli.Flag{
  14. &cli.StringFlag{Name: "config", Aliases: []string{"c"}, EnvVars: []string{"NTFY_CONFIG_FILE"}, Value: "/etc/ntfy/server.yml", DefaultText: "/etc/ntfy/server.yml", Usage: "config file"},
  15. altsrc.NewStringFlag(&cli.StringFlag{Name: "base-url", Aliases: []string{"B"}, EnvVars: []string{"NTFY_BASE_URL"}, Usage: "externally visible base URL for this host (e.g. https://ntfy.sh)"}),
  16. altsrc.NewStringFlag(&cli.StringFlag{Name: "listen-http", Aliases: []string{"l"}, EnvVars: []string{"NTFY_LISTEN_HTTP"}, Value: server.DefaultListenHTTP, Usage: "ip:port used to as HTTP listen address"}),
  17. altsrc.NewStringFlag(&cli.StringFlag{Name: "listen-https", Aliases: []string{"L"}, EnvVars: []string{"NTFY_LISTEN_HTTPS"}, Usage: "ip:port used to as HTTPS listen address"}),
  18. altsrc.NewStringFlag(&cli.StringFlag{Name: "key-file", Aliases: []string{"K"}, EnvVars: []string{"NTFY_KEY_FILE"}, Usage: "private key file, if listen-https is set"}),
  19. altsrc.NewStringFlag(&cli.StringFlag{Name: "cert-file", Aliases: []string{"E"}, EnvVars: []string{"NTFY_CERT_FILE"}, Usage: "certificate file, if listen-https is set"}),
  20. altsrc.NewStringFlag(&cli.StringFlag{Name: "firebase-key-file", Aliases: []string{"F"}, EnvVars: []string{"NTFY_FIREBASE_KEY_FILE"}, Usage: "Firebase credentials file; if set additionally publish to FCM topic"}),
  21. altsrc.NewStringFlag(&cli.StringFlag{Name: "cache-file", Aliases: []string{"C"}, EnvVars: []string{"NTFY_CACHE_FILE"}, Usage: "cache file used for message caching"}),
  22. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "cache-duration", Aliases: []string{"b"}, EnvVars: []string{"NTFY_CACHE_DURATION"}, Value: server.DefaultCacheDuration, Usage: "buffer messages for this time to allow `since` requests"}),
  23. altsrc.NewStringFlag(&cli.StringFlag{Name: "attachment-cache-dir", EnvVars: []string{"NTFY_ATTACHMENT_CACHE_DIR"}, Usage: "cache directory for attached files"}),
  24. altsrc.NewStringFlag(&cli.StringFlag{Name: "attachment-total-size-limit", Aliases: []string{"A"}, EnvVars: []string{"NTFY_ATTACHMENT_TOTAL_SIZE_LIMIT"}, DefaultText: "5G", Usage: "limit of the on-disk attachment cache"}),
  25. altsrc.NewStringFlag(&cli.StringFlag{Name: "attachment-file-size-limit", Aliases: []string{"Y"}, EnvVars: []string{"NTFY_ATTACHMENT_FILE_SIZE_LIMIT"}, DefaultText: "15M", Usage: "per-file attachment size limit (e.g. 300k, 2M, 100M)"}),
  26. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "attachment-expiry-duration", Aliases: []string{"X"}, EnvVars: []string{"NTFY_ATTACHMENT_EXPIRY_DURATION"}, Value: server.DefaultAttachmentExpiryDuration, DefaultText: "3h", Usage: "duration after which uploaded attachments will be deleted (e.g. 3h, 20h)"}),
  27. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "keepalive-interval", Aliases: []string{"k"}, EnvVars: []string{"NTFY_KEEPALIVE_INTERVAL"}, Value: server.DefaultKeepaliveInterval, Usage: "interval of keepalive messages"}),
  28. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "manager-interval", Aliases: []string{"m"}, EnvVars: []string{"NTFY_MANAGER_INTERVAL"}, Value: server.DefaultManagerInterval, Usage: "interval of for message pruning and stats printing"}),
  29. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-sender-addr", EnvVars: []string{"NTFY_SMTP_SENDER_ADDR"}, Usage: "SMTP server address (host:port) for outgoing emails"}),
  30. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-sender-user", EnvVars: []string{"NTFY_SMTP_SENDER_USER"}, Usage: "SMTP user (if e-mail sending is enabled)"}),
  31. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-sender-pass", EnvVars: []string{"NTFY_SMTP_SENDER_PASS"}, Usage: "SMTP password (if e-mail sending is enabled)"}),
  32. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-sender-from", EnvVars: []string{"NTFY_SMTP_SENDER_FROM"}, Usage: "SMTP sender address (if e-mail sending is enabled)"}),
  33. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-server-listen", EnvVars: []string{"NTFY_SMTP_SERVER_LISTEN"}, Usage: "SMTP server address (ip:port) for incoming emails, e.g. :25"}),
  34. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-server-domain", EnvVars: []string{"NTFY_SMTP_SERVER_DOMAIN"}, Usage: "SMTP domain for incoming e-mail, e.g. ntfy.sh"}),
  35. altsrc.NewStringFlag(&cli.StringFlag{Name: "smtp-server-addr-prefix", EnvVars: []string{"NTFY_SMTP_SERVER_ADDR_PREFIX"}, Usage: "SMTP email address prefix for topics to prevent spam (e.g. 'ntfy-')"}),
  36. altsrc.NewIntFlag(&cli.IntFlag{Name: "global-topic-limit", Aliases: []string{"T"}, EnvVars: []string{"NTFY_GLOBAL_TOPIC_LIMIT"}, Value: server.DefaultTotalTopicLimit, Usage: "total number of topics allowed"}),
  37. altsrc.NewIntFlag(&cli.IntFlag{Name: "visitor-subscription-limit", EnvVars: []string{"NTFY_VISITOR_SUBSCRIPTION_LIMIT"}, Value: server.DefaultVisitorSubscriptionLimit, Usage: "number of subscriptions per visitor"}),
  38. altsrc.NewStringFlag(&cli.StringFlag{Name: "visitor-attachment-total-size-limit", EnvVars: []string{"NTFY_VISITOR_ATTACHMENT_TOTAL_SIZE_LIMIT"}, Value: "100M", Usage: "total storage limit used for attachments per visitor"}),
  39. altsrc.NewStringFlag(&cli.StringFlag{Name: "visitor-attachment-daily-bandwidth-limit", EnvVars: []string{"NTFY_VISITOR_ATTACHMENT_DAILY_BANDWIDTH_LIMIT"}, Value: "500M", Usage: "total daily attachment download/upload bandwidth limit per visitor"}),
  40. altsrc.NewIntFlag(&cli.IntFlag{Name: "visitor-request-limit-burst", EnvVars: []string{"NTFY_VISITOR_REQUEST_LIMIT_BURST"}, Value: server.DefaultVisitorRequestLimitBurst, Usage: "initial limit of requests per visitor"}),
  41. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "visitor-request-limit-replenish", EnvVars: []string{"NTFY_VISITOR_REQUEST_LIMIT_REPLENISH"}, Value: server.DefaultVisitorRequestLimitReplenish, Usage: "interval at which burst limit is replenished (one per x)"}),
  42. altsrc.NewIntFlag(&cli.IntFlag{Name: "visitor-email-limit-burst", EnvVars: []string{"NTFY_VISITOR_EMAIL_LIMIT_BURST"}, Value: server.DefaultVisitorEmailLimitBurst, Usage: "initial limit of e-mails per visitor"}),
  43. altsrc.NewDurationFlag(&cli.DurationFlag{Name: "visitor-email-limit-replenish", EnvVars: []string{"NTFY_VISITOR_EMAIL_LIMIT_REPLENISH"}, Value: server.DefaultVisitorEmailLimitReplenish, Usage: "interval at which burst limit is replenished (one per x)"}),
  44. altsrc.NewBoolFlag(&cli.BoolFlag{Name: "behind-proxy", Aliases: []string{"P"}, EnvVars: []string{"NTFY_BEHIND_PROXY"}, Value: false, Usage: "if set, use X-Forwarded-For header to determine visitor IP address (for rate limiting)"}),
  45. }
  46. var cmdServe = &cli.Command{
  47. Name: "serve",
  48. Usage: "Run the ntfy server",
  49. UsageText: "ntfy serve [OPTIONS..]",
  50. Action: execServe,
  51. Flags: flagsServe,
  52. Before: initConfigFileInputSource("config", flagsServe),
  53. Description: `Run the ntfy server and listen for incoming requests
  54. The command will load the configuration from /etc/ntfy/server.yml. Config options can
  55. be overridden using the command line options.
  56. Examples:
  57. ntfy serve # Starts server in the foreground (on port 80)
  58. ntfy serve --listen-http :8080 # Starts server with alternate port`,
  59. }
  60. func execServe(c *cli.Context) error {
  61. if c.NArg() > 0 {
  62. return errors.New("no arguments expected, see 'ntfy serve --help' for help")
  63. }
  64. // Read all the options
  65. baseURL := c.String("base-url")
  66. listenHTTP := c.String("listen-http")
  67. listenHTTPS := c.String("listen-https")
  68. keyFile := c.String("key-file")
  69. certFile := c.String("cert-file")
  70. firebaseKeyFile := c.String("firebase-key-file")
  71. cacheFile := c.String("cache-file")
  72. cacheDuration := c.Duration("cache-duration")
  73. attachmentCacheDir := c.String("attachment-cache-dir")
  74. attachmentTotalSizeLimitStr := c.String("attachment-total-size-limit")
  75. attachmentFileSizeLimitStr := c.String("attachment-file-size-limit")
  76. attachmentExpiryDuration := c.Duration("attachment-expiry-duration")
  77. keepaliveInterval := c.Duration("keepalive-interval")
  78. managerInterval := c.Duration("manager-interval")
  79. smtpSenderAddr := c.String("smtp-sender-addr")
  80. smtpSenderUser := c.String("smtp-sender-user")
  81. smtpSenderPass := c.String("smtp-sender-pass")
  82. smtpSenderFrom := c.String("smtp-sender-from")
  83. smtpServerListen := c.String("smtp-server-listen")
  84. smtpServerDomain := c.String("smtp-server-domain")
  85. smtpServerAddrPrefix := c.String("smtp-server-addr-prefix")
  86. totalTopicLimit := c.Int("global-topic-limit")
  87. visitorSubscriptionLimit := c.Int("visitor-subscription-limit")
  88. visitorAttachmentTotalSizeLimitStr := c.String("visitor-attachment-total-size-limit")
  89. visitorAttachmentDailyBandwidthLimitStr := c.String("visitor-attachment-daily-bandwidth-limit")
  90. visitorRequestLimitBurst := c.Int("visitor-request-limit-burst")
  91. visitorRequestLimitReplenish := c.Duration("visitor-request-limit-replenish")
  92. visitorEmailLimitBurst := c.Int("visitor-email-limit-burst")
  93. visitorEmailLimitReplenish := c.Duration("visitor-email-limit-replenish")
  94. behindProxy := c.Bool("behind-proxy")
  95. // Check values
  96. if firebaseKeyFile != "" && !util.FileExists(firebaseKeyFile) {
  97. return errors.New("if set, FCM key file must exist")
  98. } else if keepaliveInterval < 5*time.Second {
  99. return errors.New("keepalive interval cannot be lower than five seconds")
  100. } else if managerInterval < 5*time.Second {
  101. return errors.New("manager interval cannot be lower than five seconds")
  102. } else if cacheDuration > 0 && cacheDuration < managerInterval {
  103. return errors.New("cache duration cannot be lower than manager interval")
  104. } else if keyFile != "" && !util.FileExists(keyFile) {
  105. return errors.New("if set, key file must exist")
  106. } else if certFile != "" && !util.FileExists(certFile) {
  107. return errors.New("if set, certificate file must exist")
  108. } else if listenHTTPS != "" && (keyFile == "" || certFile == "") {
  109. return errors.New("if listen-https is set, both key-file and cert-file must be set")
  110. } else if smtpSenderAddr != "" && (baseURL == "" || smtpSenderUser == "" || smtpSenderPass == "" || smtpSenderFrom == "") {
  111. return errors.New("if smtp-sender-addr is set, base-url, smtp-sender-user, smtp-sender-pass and smtp-sender-from must also be set")
  112. } else if smtpServerListen != "" && smtpServerDomain == "" {
  113. return errors.New("if smtp-server-listen is set, smtp-server-domain must also be set")
  114. }
  115. // Convert sizes to bytes
  116. attachmentTotalSizeLimit, err := parseSize(attachmentTotalSizeLimitStr, server.DefaultAttachmentTotalSizeLimit)
  117. if err != nil {
  118. return err
  119. }
  120. attachmentFileSizeLimit, err := parseSize(attachmentFileSizeLimitStr, server.DefaultAttachmentFileSizeLimit)
  121. if err != nil {
  122. return err
  123. }
  124. visitorAttachmentTotalSizeLimit, err := parseSize(visitorAttachmentTotalSizeLimitStr, server.DefaultVisitorAttachmentTotalSizeLimit)
  125. if err != nil {
  126. return err
  127. }
  128. visitorAttachmentDailyBandwidthLimit, err := parseSize(visitorAttachmentDailyBandwidthLimitStr, server.DefaultVisitorAttachmentDailyBandwidthLimit)
  129. if err != nil {
  130. return err
  131. } else if visitorAttachmentDailyBandwidthLimit > math.MaxInt {
  132. return fmt.Errorf("config option visitor-attachment-daily-bandwidth-limit must be lower than %d", math.MaxInt)
  133. }
  134. // Run server
  135. conf := server.NewConfig()
  136. conf.BaseURL = baseURL
  137. conf.ListenHTTP = listenHTTP
  138. conf.ListenHTTPS = listenHTTPS
  139. conf.KeyFile = keyFile
  140. conf.CertFile = certFile
  141. conf.FirebaseKeyFile = firebaseKeyFile
  142. conf.CacheFile = cacheFile
  143. conf.CacheDuration = cacheDuration
  144. conf.AttachmentCacheDir = attachmentCacheDir
  145. conf.AttachmentTotalSizeLimit = attachmentTotalSizeLimit
  146. conf.AttachmentFileSizeLimit = attachmentFileSizeLimit
  147. conf.AttachmentExpiryDuration = attachmentExpiryDuration
  148. conf.KeepaliveInterval = keepaliveInterval
  149. conf.ManagerInterval = managerInterval
  150. conf.SMTPSenderAddr = smtpSenderAddr
  151. conf.SMTPSenderUser = smtpSenderUser
  152. conf.SMTPSenderPass = smtpSenderPass
  153. conf.SMTPSenderFrom = smtpSenderFrom
  154. conf.SMTPServerListen = smtpServerListen
  155. conf.SMTPServerDomain = smtpServerDomain
  156. conf.SMTPServerAddrPrefix = smtpServerAddrPrefix
  157. conf.TotalTopicLimit = totalTopicLimit
  158. conf.VisitorSubscriptionLimit = visitorSubscriptionLimit
  159. conf.VisitorAttachmentTotalSizeLimit = visitorAttachmentTotalSizeLimit
  160. conf.VisitorAttachmentDailyBandwidthLimit = int(visitorAttachmentDailyBandwidthLimit)
  161. conf.VisitorRequestLimitBurst = visitorRequestLimitBurst
  162. conf.VisitorRequestLimitReplenish = visitorRequestLimitReplenish
  163. conf.VisitorEmailLimitBurst = visitorEmailLimitBurst
  164. conf.VisitorEmailLimitReplenish = visitorEmailLimitReplenish
  165. conf.BehindProxy = behindProxy
  166. s, err := server.New(conf)
  167. if err != nil {
  168. log.Fatalln(err)
  169. }
  170. if err := s.Run(); err != nil {
  171. log.Fatalln(err)
  172. }
  173. log.Printf("Exiting.")
  174. return nil
  175. }
  176. func parseSize(s string, defaultValue int64) (v int64, err error) {
  177. if s == "" {
  178. return defaultValue, nil
  179. }
  180. v, err = util.ParseSize(s)
  181. if err != nil {
  182. return 0, err
  183. }
  184. return v, nil
  185. }