options.go 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826
  1. // SPDX-FileCopyrightText: Copyright The Miniflux Authors. All rights reserved.
  2. // SPDX-License-Identifier: Apache-2.0
  3. package config // import "miniflux.app/v2/internal/config"
  4. import (
  5. "fmt"
  6. "net/url"
  7. "sort"
  8. "strings"
  9. "time"
  10. "miniflux.app/v2/internal/crypto"
  11. "miniflux.app/v2/internal/version"
  12. )
  13. const (
  14. defaultHTTPS = false
  15. defaultLogFile = "stderr"
  16. defaultLogDateTime = false
  17. defaultLogFormat = "text"
  18. defaultLogLevel = "info"
  19. defaultHSTS = true
  20. defaultHTTPService = true
  21. defaultSchedulerService = true
  22. defaultDebug = false
  23. defaultTiming = false
  24. defaultBaseURL = "http://localhost"
  25. defaultRootURL = "http://localhost"
  26. defaultBasePath = ""
  27. defaultWorkerPoolSize = 16
  28. defaultPollingFrequency = 60
  29. defaultForceRefreshInterval = 30
  30. defaultBatchSize = 100
  31. defaultPollingScheduler = "round_robin"
  32. defaultSchedulerEntryFrequencyMinInterval = 5
  33. defaultSchedulerEntryFrequencyMaxInterval = 24 * 60
  34. defaultSchedulerEntryFrequencyFactor = 1
  35. defaultSchedulerRoundRobinMinInterval = 60
  36. defaultSchedulerRoundRobinMaxInterval = 1440
  37. defaultPollingParsingErrorLimit = 3
  38. defaultRunMigrations = false
  39. defaultDatabaseURL = "user=postgres password=postgres dbname=miniflux2 sslmode=disable"
  40. defaultDatabaseMaxConns = 20
  41. defaultDatabaseMinConns = 1
  42. defaultDatabaseConnectionLifetime = 5
  43. defaultListenAddr = "127.0.0.1:8080"
  44. defaultCertFile = ""
  45. defaultKeyFile = ""
  46. defaultCertDomain = ""
  47. defaultCleanupFrequencyHours = 24
  48. defaultCleanupArchiveReadDays = 60
  49. defaultCleanupArchiveUnreadDays = 180
  50. defaultCleanupArchiveBatchSize = 10000
  51. defaultCleanupRemoveSessionsDays = 30
  52. defaultMediaProxyHTTPClientTimeout = 120
  53. defaultMediaProxyMode = "http-only"
  54. defaultMediaResourceTypes = "image"
  55. defaultMediaProxyURL = ""
  56. defaultFilterEntryMaxAgeDays = 0
  57. defaultFetchBilibiliWatchTime = false
  58. defaultFetchNebulaWatchTime = false
  59. defaultFetchOdyseeWatchTime = false
  60. defaultFetchYouTubeWatchTime = false
  61. defaultYouTubeApiKey = ""
  62. defaultYouTubeEmbedUrlOverride = "https://www.youtube-nocookie.com/embed/"
  63. defaultCreateAdmin = false
  64. defaultAdminUsername = ""
  65. defaultAdminPassword = ""
  66. defaultOAuth2UserCreation = false
  67. defaultOAuth2ClientID = ""
  68. defaultOAuth2ClientSecret = ""
  69. defaultOAuth2RedirectURL = ""
  70. defaultOAuth2OidcDiscoveryEndpoint = ""
  71. defaultOauth2OidcProviderName = "OpenID Connect"
  72. defaultOAuth2Provider = ""
  73. defaultDisableLocalAuth = false
  74. defaultPocketConsumerKey = ""
  75. defaultHTTPClientTimeout = 20
  76. defaultHTTPClientMaxBodySize = 15
  77. defaultHTTPClientProxy = ""
  78. defaultHTTPServerTimeout = 300
  79. defaultAuthProxyHeader = ""
  80. defaultAuthProxyUserCreation = false
  81. defaultMaintenanceMode = false
  82. defaultMaintenanceMessage = "Miniflux is currently under maintenance"
  83. defaultMetricsCollector = false
  84. defaultMetricsRefreshInterval = 60
  85. defaultMetricsAllowedNetworks = "127.0.0.1/8"
  86. defaultMetricsUsername = ""
  87. defaultMetricsPassword = ""
  88. defaultWatchdog = true
  89. defaultInvidiousInstance = "yewtu.be"
  90. defaultWebAuthn = false
  91. )
  92. var defaultHTTPClientUserAgent = "Mozilla/5.0 (compatible; Miniflux/" + version.Version + "; +https://miniflux.app)"
  93. // Option contains a key to value map of a single option. It may be used to output debug strings.
  94. type Option struct {
  95. Key string
  96. Value interface{}
  97. }
  98. // Options contains configuration options.
  99. type Options struct {
  100. HTTPS bool
  101. logFile string
  102. logDateTime bool
  103. logFormat string
  104. logLevel string
  105. hsts bool
  106. httpService bool
  107. schedulerService bool
  108. serverTimingHeader bool
  109. baseURL string
  110. rootURL string
  111. basePath string
  112. databaseURL string
  113. databaseMaxConns int
  114. databaseMinConns int
  115. databaseConnectionLifetime int
  116. runMigrations bool
  117. listenAddr string
  118. certFile string
  119. certDomain string
  120. certKeyFile string
  121. cleanupFrequencyHours int
  122. cleanupArchiveReadDays int
  123. cleanupArchiveUnreadDays int
  124. cleanupArchiveBatchSize int
  125. cleanupRemoveSessionsDays int
  126. pollingFrequency int
  127. forceRefreshInterval int
  128. batchSize int
  129. pollingScheduler string
  130. schedulerEntryFrequencyMinInterval int
  131. schedulerEntryFrequencyMaxInterval int
  132. schedulerEntryFrequencyFactor int
  133. schedulerRoundRobinMinInterval int
  134. schedulerRoundRobinMaxInterval int
  135. pollingParsingErrorLimit int
  136. workerPoolSize int
  137. createAdmin bool
  138. adminUsername string
  139. adminPassword string
  140. mediaProxyHTTPClientTimeout int
  141. mediaProxyMode string
  142. mediaProxyResourceTypes []string
  143. mediaProxyCustomURL string
  144. fetchBilibiliWatchTime bool
  145. fetchNebulaWatchTime bool
  146. fetchOdyseeWatchTime bool
  147. fetchYouTubeWatchTime bool
  148. filterEntryMaxAgeDays int
  149. youTubeApiKey string
  150. youTubeEmbedUrlOverride string
  151. oauth2UserCreationAllowed bool
  152. oauth2ClientID string
  153. oauth2ClientSecret string
  154. oauth2RedirectURL string
  155. oidcDiscoveryEndpoint string
  156. oidcProviderName string
  157. oauth2Provider string
  158. disableLocalAuth bool
  159. pocketConsumerKey string
  160. httpClientTimeout int
  161. httpClientMaxBodySize int64
  162. httpClientProxyURL *url.URL
  163. httpClientProxies []string
  164. httpClientUserAgent string
  165. httpServerTimeout int
  166. authProxyHeader string
  167. authProxyUserCreation bool
  168. maintenanceMode bool
  169. maintenanceMessage string
  170. metricsCollector bool
  171. metricsRefreshInterval int
  172. metricsAllowedNetworks []string
  173. metricsUsername string
  174. metricsPassword string
  175. watchdog bool
  176. invidiousInstance string
  177. mediaProxyPrivateKey []byte
  178. webAuthn bool
  179. }
  180. // NewOptions returns Options with default values.
  181. func NewOptions() *Options {
  182. return &Options{
  183. HTTPS: defaultHTTPS,
  184. logFile: defaultLogFile,
  185. logDateTime: defaultLogDateTime,
  186. logFormat: defaultLogFormat,
  187. logLevel: defaultLogLevel,
  188. hsts: defaultHSTS,
  189. httpService: defaultHTTPService,
  190. schedulerService: defaultSchedulerService,
  191. serverTimingHeader: defaultTiming,
  192. baseURL: defaultBaseURL,
  193. rootURL: defaultRootURL,
  194. basePath: defaultBasePath,
  195. databaseURL: defaultDatabaseURL,
  196. databaseMaxConns: defaultDatabaseMaxConns,
  197. databaseMinConns: defaultDatabaseMinConns,
  198. databaseConnectionLifetime: defaultDatabaseConnectionLifetime,
  199. runMigrations: defaultRunMigrations,
  200. listenAddr: defaultListenAddr,
  201. certFile: defaultCertFile,
  202. certDomain: defaultCertDomain,
  203. certKeyFile: defaultKeyFile,
  204. cleanupFrequencyHours: defaultCleanupFrequencyHours,
  205. cleanupArchiveReadDays: defaultCleanupArchiveReadDays,
  206. cleanupArchiveUnreadDays: defaultCleanupArchiveUnreadDays,
  207. cleanupArchiveBatchSize: defaultCleanupArchiveBatchSize,
  208. cleanupRemoveSessionsDays: defaultCleanupRemoveSessionsDays,
  209. pollingFrequency: defaultPollingFrequency,
  210. forceRefreshInterval: defaultForceRefreshInterval,
  211. batchSize: defaultBatchSize,
  212. pollingScheduler: defaultPollingScheduler,
  213. schedulerEntryFrequencyMinInterval: defaultSchedulerEntryFrequencyMinInterval,
  214. schedulerEntryFrequencyMaxInterval: defaultSchedulerEntryFrequencyMaxInterval,
  215. schedulerEntryFrequencyFactor: defaultSchedulerEntryFrequencyFactor,
  216. schedulerRoundRobinMinInterval: defaultSchedulerRoundRobinMinInterval,
  217. schedulerRoundRobinMaxInterval: defaultSchedulerRoundRobinMaxInterval,
  218. pollingParsingErrorLimit: defaultPollingParsingErrorLimit,
  219. workerPoolSize: defaultWorkerPoolSize,
  220. createAdmin: defaultCreateAdmin,
  221. mediaProxyHTTPClientTimeout: defaultMediaProxyHTTPClientTimeout,
  222. mediaProxyMode: defaultMediaProxyMode,
  223. mediaProxyResourceTypes: []string{defaultMediaResourceTypes},
  224. mediaProxyCustomURL: defaultMediaProxyURL,
  225. filterEntryMaxAgeDays: defaultFilterEntryMaxAgeDays,
  226. fetchBilibiliWatchTime: defaultFetchBilibiliWatchTime,
  227. fetchNebulaWatchTime: defaultFetchNebulaWatchTime,
  228. fetchOdyseeWatchTime: defaultFetchOdyseeWatchTime,
  229. fetchYouTubeWatchTime: defaultFetchYouTubeWatchTime,
  230. youTubeApiKey: defaultYouTubeApiKey,
  231. youTubeEmbedUrlOverride: defaultYouTubeEmbedUrlOverride,
  232. oauth2UserCreationAllowed: defaultOAuth2UserCreation,
  233. oauth2ClientID: defaultOAuth2ClientID,
  234. oauth2ClientSecret: defaultOAuth2ClientSecret,
  235. oauth2RedirectURL: defaultOAuth2RedirectURL,
  236. oidcDiscoveryEndpoint: defaultOAuth2OidcDiscoveryEndpoint,
  237. oidcProviderName: defaultOauth2OidcProviderName,
  238. oauth2Provider: defaultOAuth2Provider,
  239. disableLocalAuth: defaultDisableLocalAuth,
  240. pocketConsumerKey: defaultPocketConsumerKey,
  241. httpClientTimeout: defaultHTTPClientTimeout,
  242. httpClientMaxBodySize: defaultHTTPClientMaxBodySize * 1024 * 1024,
  243. httpClientProxyURL: nil,
  244. httpClientProxies: []string{},
  245. httpClientUserAgent: defaultHTTPClientUserAgent,
  246. httpServerTimeout: defaultHTTPServerTimeout,
  247. authProxyHeader: defaultAuthProxyHeader,
  248. authProxyUserCreation: defaultAuthProxyUserCreation,
  249. maintenanceMode: defaultMaintenanceMode,
  250. maintenanceMessage: defaultMaintenanceMessage,
  251. metricsCollector: defaultMetricsCollector,
  252. metricsRefreshInterval: defaultMetricsRefreshInterval,
  253. metricsAllowedNetworks: []string{defaultMetricsAllowedNetworks},
  254. metricsUsername: defaultMetricsUsername,
  255. metricsPassword: defaultMetricsPassword,
  256. watchdog: defaultWatchdog,
  257. invidiousInstance: defaultInvidiousInstance,
  258. mediaProxyPrivateKey: crypto.GenerateRandomBytes(16),
  259. webAuthn: defaultWebAuthn,
  260. }
  261. }
  262. func (o *Options) LogFile() string {
  263. return o.logFile
  264. }
  265. // LogDateTime returns true if the date/time should be displayed in log messages.
  266. func (o *Options) LogDateTime() bool {
  267. return o.logDateTime
  268. }
  269. // LogFormat returns the log format.
  270. func (o *Options) LogFormat() string {
  271. return o.logFormat
  272. }
  273. // LogLevel returns the log level.
  274. func (o *Options) LogLevel() string {
  275. return o.logLevel
  276. }
  277. // SetLogLevel sets the log level.
  278. func (o *Options) SetLogLevel(level string) {
  279. o.logLevel = level
  280. }
  281. // HasMaintenanceMode returns true if maintenance mode is enabled.
  282. func (o *Options) HasMaintenanceMode() bool {
  283. return o.maintenanceMode
  284. }
  285. // MaintenanceMessage returns maintenance message.
  286. func (o *Options) MaintenanceMessage() string {
  287. return o.maintenanceMessage
  288. }
  289. // HasServerTimingHeader returns true if server-timing headers enabled.
  290. func (o *Options) HasServerTimingHeader() bool {
  291. return o.serverTimingHeader
  292. }
  293. // BaseURL returns the application base URL with path.
  294. func (o *Options) BaseURL() string {
  295. return o.baseURL
  296. }
  297. // RootURL returns the base URL without path.
  298. func (o *Options) RootURL() string {
  299. return o.rootURL
  300. }
  301. // BasePath returns the application base path according to the base URL.
  302. func (o *Options) BasePath() string {
  303. return o.basePath
  304. }
  305. // IsDefaultDatabaseURL returns true if the default database URL is used.
  306. func (o *Options) IsDefaultDatabaseURL() bool {
  307. return o.databaseURL == defaultDatabaseURL
  308. }
  309. // DatabaseURL returns the database URL.
  310. func (o *Options) DatabaseURL() string {
  311. return o.databaseURL
  312. }
  313. // DatabaseMaxConns returns the maximum number of database connections.
  314. func (o *Options) DatabaseMaxConns() int {
  315. return o.databaseMaxConns
  316. }
  317. // DatabaseMinConns returns the minimum number of database connections.
  318. func (o *Options) DatabaseMinConns() int {
  319. return o.databaseMinConns
  320. }
  321. // DatabaseConnectionLifetime returns the maximum amount of time a connection may be reused.
  322. func (o *Options) DatabaseConnectionLifetime() time.Duration {
  323. return time.Duration(o.databaseConnectionLifetime) * time.Minute
  324. }
  325. // ListenAddr returns the listen address for the HTTP server.
  326. func (o *Options) ListenAddr() string {
  327. return o.listenAddr
  328. }
  329. // CertFile returns the SSL certificate filename if any.
  330. func (o *Options) CertFile() string {
  331. return o.certFile
  332. }
  333. // CertKeyFile returns the private key filename for custom SSL certificate.
  334. func (o *Options) CertKeyFile() string {
  335. return o.certKeyFile
  336. }
  337. // CertDomain returns the domain to use for Let's Encrypt certificate.
  338. func (o *Options) CertDomain() string {
  339. return o.certDomain
  340. }
  341. // CleanupFrequencyHours returns the interval in hours for cleanup jobs.
  342. func (o *Options) CleanupFrequencyHours() int {
  343. return o.cleanupFrequencyHours
  344. }
  345. // CleanupArchiveReadDays returns the number of days after which marking read items as removed.
  346. func (o *Options) CleanupArchiveReadDays() int {
  347. return o.cleanupArchiveReadDays
  348. }
  349. // CleanupArchiveUnreadDays returns the number of days after which marking unread items as removed.
  350. func (o *Options) CleanupArchiveUnreadDays() int {
  351. return o.cleanupArchiveUnreadDays
  352. }
  353. // CleanupArchiveBatchSize returns the number of entries to archive for each interval.
  354. func (o *Options) CleanupArchiveBatchSize() int {
  355. return o.cleanupArchiveBatchSize
  356. }
  357. // CleanupRemoveSessionsDays returns the number of days after which to remove sessions.
  358. func (o *Options) CleanupRemoveSessionsDays() int {
  359. return o.cleanupRemoveSessionsDays
  360. }
  361. // WorkerPoolSize returns the number of background worker.
  362. func (o *Options) WorkerPoolSize() int {
  363. return o.workerPoolSize
  364. }
  365. // PollingFrequency returns the interval to refresh feeds in the background.
  366. func (o *Options) PollingFrequency() int {
  367. return o.pollingFrequency
  368. }
  369. // ForceRefreshInterval returns the force refresh interval
  370. func (o *Options) ForceRefreshInterval() int {
  371. return o.forceRefreshInterval
  372. }
  373. // BatchSize returns the number of feeds to send for background processing.
  374. func (o *Options) BatchSize() int {
  375. return o.batchSize
  376. }
  377. // PollingScheduler returns the scheduler used for polling feeds.
  378. func (o *Options) PollingScheduler() string {
  379. return o.pollingScheduler
  380. }
  381. // SchedulerEntryFrequencyMaxInterval returns the maximum interval in minutes for the entry frequency scheduler.
  382. func (o *Options) SchedulerEntryFrequencyMaxInterval() int {
  383. return o.schedulerEntryFrequencyMaxInterval
  384. }
  385. // SchedulerEntryFrequencyMinInterval returns the minimum interval in minutes for the entry frequency scheduler.
  386. func (o *Options) SchedulerEntryFrequencyMinInterval() int {
  387. return o.schedulerEntryFrequencyMinInterval
  388. }
  389. // SchedulerEntryFrequencyFactor returns the factor for the entry frequency scheduler.
  390. func (o *Options) SchedulerEntryFrequencyFactor() int {
  391. return o.schedulerEntryFrequencyFactor
  392. }
  393. func (o *Options) SchedulerRoundRobinMinInterval() int {
  394. return o.schedulerRoundRobinMinInterval
  395. }
  396. func (o *Options) SchedulerRoundRobinMaxInterval() int {
  397. return o.schedulerRoundRobinMaxInterval
  398. }
  399. // PollingParsingErrorLimit returns the limit of errors when to stop polling.
  400. func (o *Options) PollingParsingErrorLimit() int {
  401. return o.pollingParsingErrorLimit
  402. }
  403. // IsOAuth2UserCreationAllowed returns true if user creation is allowed for OAuth2 users.
  404. func (o *Options) IsOAuth2UserCreationAllowed() bool {
  405. return o.oauth2UserCreationAllowed
  406. }
  407. // OAuth2ClientID returns the OAuth2 Client ID.
  408. func (o *Options) OAuth2ClientID() string {
  409. return o.oauth2ClientID
  410. }
  411. // OAuth2ClientSecret returns the OAuth2 client secret.
  412. func (o *Options) OAuth2ClientSecret() string {
  413. return o.oauth2ClientSecret
  414. }
  415. // OAuth2RedirectURL returns the OAuth2 redirect URL.
  416. func (o *Options) OAuth2RedirectURL() string {
  417. return o.oauth2RedirectURL
  418. }
  419. // OIDCDiscoveryEndpoint returns the OAuth2 OIDC discovery endpoint.
  420. func (o *Options) OIDCDiscoveryEndpoint() string {
  421. return o.oidcDiscoveryEndpoint
  422. }
  423. // OIDCProviderName returns the OAuth2 OIDC provider's display name
  424. func (o *Options) OIDCProviderName() string {
  425. return o.oidcProviderName
  426. }
  427. // OAuth2Provider returns the name of the OAuth2 provider configured.
  428. func (o *Options) OAuth2Provider() string {
  429. return o.oauth2Provider
  430. }
  431. // DisableLocalAUth returns true if the local user database should not be used to authenticate users
  432. func (o *Options) DisableLocalAuth() bool {
  433. return o.disableLocalAuth
  434. }
  435. // HasHSTS returns true if HTTP Strict Transport Security is enabled.
  436. func (o *Options) HasHSTS() bool {
  437. return o.hsts
  438. }
  439. // RunMigrations returns true if the environment variable RUN_MIGRATIONS is not empty.
  440. func (o *Options) RunMigrations() bool {
  441. return o.runMigrations
  442. }
  443. // CreateAdmin returns true if the environment variable CREATE_ADMIN is not empty.
  444. func (o *Options) CreateAdmin() bool {
  445. return o.createAdmin
  446. }
  447. // AdminUsername returns the admin username if defined.
  448. func (o *Options) AdminUsername() string {
  449. return o.adminUsername
  450. }
  451. // AdminPassword returns the admin password if defined.
  452. func (o *Options) AdminPassword() string {
  453. return o.adminPassword
  454. }
  455. // FetchYouTubeWatchTime returns true if the YouTube video duration
  456. // should be fetched and used as a reading time.
  457. func (o *Options) FetchYouTubeWatchTime() bool {
  458. return o.fetchYouTubeWatchTime
  459. }
  460. // YouTubeApiKey returns the YouTube API key if defined.
  461. func (o *Options) YouTubeApiKey() string {
  462. return o.youTubeApiKey
  463. }
  464. // YouTubeEmbedUrlOverride returns YouTube URL which will be used for embeds
  465. func (o *Options) YouTubeEmbedUrlOverride() string {
  466. return o.youTubeEmbedUrlOverride
  467. }
  468. // FetchNebulaWatchTime returns true if the Nebula video duration
  469. // should be fetched and used as a reading time.
  470. func (o *Options) FetchNebulaWatchTime() bool {
  471. return o.fetchNebulaWatchTime
  472. }
  473. // FetchOdyseeWatchTime returns true if the Odysee video duration
  474. // should be fetched and used as a reading time.
  475. func (o *Options) FetchOdyseeWatchTime() bool {
  476. return o.fetchOdyseeWatchTime
  477. }
  478. // FetchBilibiliWatchTime returns true if the Bilibili video duration
  479. // should be fetched and used as a reading time.
  480. func (o *Options) FetchBilibiliWatchTime() bool {
  481. return o.fetchBilibiliWatchTime
  482. }
  483. // MediaProxyMode returns "none" to never proxy, "http-only" to proxy non-HTTPS, "all" to always proxy.
  484. func (o *Options) MediaProxyMode() string {
  485. return o.mediaProxyMode
  486. }
  487. // MediaProxyResourceTypes returns a slice of resource types to proxy.
  488. func (o *Options) MediaProxyResourceTypes() []string {
  489. return o.mediaProxyResourceTypes
  490. }
  491. // MediaCustomProxyURL returns the custom proxy URL for medias.
  492. func (o *Options) MediaCustomProxyURL() string {
  493. return o.mediaProxyCustomURL
  494. }
  495. // MediaProxyHTTPClientTimeout returns the time limit in seconds before the proxy HTTP client cancel the request.
  496. func (o *Options) MediaProxyHTTPClientTimeout() int {
  497. return o.mediaProxyHTTPClientTimeout
  498. }
  499. // MediaProxyPrivateKey returns the private key used by the media proxy.
  500. func (o *Options) MediaProxyPrivateKey() []byte {
  501. return o.mediaProxyPrivateKey
  502. }
  503. // HasHTTPService returns true if the HTTP service is enabled.
  504. func (o *Options) HasHTTPService() bool {
  505. return o.httpService
  506. }
  507. // HasSchedulerService returns true if the scheduler service is enabled.
  508. func (o *Options) HasSchedulerService() bool {
  509. return o.schedulerService
  510. }
  511. // PocketConsumerKey returns the Pocket Consumer Key if configured.
  512. func (o *Options) PocketConsumerKey(defaultValue string) string {
  513. if o.pocketConsumerKey != "" {
  514. return o.pocketConsumerKey
  515. }
  516. return defaultValue
  517. }
  518. // HTTPClientTimeout returns the time limit in seconds before the HTTP client cancel the request.
  519. func (o *Options) HTTPClientTimeout() int {
  520. return o.httpClientTimeout
  521. }
  522. // HTTPClientMaxBodySize returns the number of bytes allowed for the HTTP client to transfer.
  523. func (o *Options) HTTPClientMaxBodySize() int64 {
  524. return o.httpClientMaxBodySize
  525. }
  526. // HTTPClientProxyURL returns the client HTTP proxy URL if configured.
  527. func (o *Options) HTTPClientProxyURL() *url.URL {
  528. return o.httpClientProxyURL
  529. }
  530. // HasHTTPClientProxyURLConfigured returns true if the client HTTP proxy URL if configured.
  531. func (o *Options) HasHTTPClientProxyURLConfigured() bool {
  532. return o.httpClientProxyURL != nil
  533. }
  534. // HTTPClientProxies returns the list of proxies.
  535. func (o *Options) HTTPClientProxies() []string {
  536. return o.httpClientProxies
  537. }
  538. // HTTPClientProxiesString returns true if the list of rotating proxies are configured.
  539. func (o *Options) HasHTTPClientProxiesConfigured() bool {
  540. return len(o.httpClientProxies) > 0
  541. }
  542. // HTTPServerTimeout returns the time limit in seconds before the HTTP server cancel the request.
  543. func (o *Options) HTTPServerTimeout() int {
  544. return o.httpServerTimeout
  545. }
  546. // AuthProxyHeader returns an HTTP header name that contains username for
  547. // authentication using auth proxy.
  548. func (o *Options) AuthProxyHeader() string {
  549. return o.authProxyHeader
  550. }
  551. // IsAuthProxyUserCreationAllowed returns true if user creation is allowed for
  552. // users authenticated using auth proxy.
  553. func (o *Options) IsAuthProxyUserCreationAllowed() bool {
  554. return o.authProxyUserCreation
  555. }
  556. // HasMetricsCollector returns true if metrics collection is enabled.
  557. func (o *Options) HasMetricsCollector() bool {
  558. return o.metricsCollector
  559. }
  560. // MetricsRefreshInterval returns the refresh interval in seconds.
  561. func (o *Options) MetricsRefreshInterval() int {
  562. return o.metricsRefreshInterval
  563. }
  564. // MetricsAllowedNetworks returns the list of networks allowed to connect to the metrics endpoint.
  565. func (o *Options) MetricsAllowedNetworks() []string {
  566. return o.metricsAllowedNetworks
  567. }
  568. func (o *Options) MetricsUsername() string {
  569. return o.metricsUsername
  570. }
  571. func (o *Options) MetricsPassword() string {
  572. return o.metricsPassword
  573. }
  574. // HTTPClientUserAgent returns the global User-Agent header for miniflux.
  575. func (o *Options) HTTPClientUserAgent() string {
  576. return o.httpClientUserAgent
  577. }
  578. // HasWatchdog returns true if the systemd watchdog is enabled.
  579. func (o *Options) HasWatchdog() bool {
  580. return o.watchdog
  581. }
  582. // InvidiousInstance returns the invidious instance used by miniflux
  583. func (o *Options) InvidiousInstance() string {
  584. return o.invidiousInstance
  585. }
  586. // WebAuthn returns true if WebAuthn logins are supported
  587. func (o *Options) WebAuthn() bool {
  588. return o.webAuthn
  589. }
  590. // FilterEntryMaxAgeDays returns the number of days after which entries should be retained.
  591. func (o *Options) FilterEntryMaxAgeDays() int {
  592. return o.filterEntryMaxAgeDays
  593. }
  594. // SortedOptions returns options as a list of key value pairs, sorted by keys.
  595. func (o *Options) SortedOptions(redactSecret bool) []*Option {
  596. var clientProxyURLRedacted string
  597. if o.httpClientProxyURL != nil {
  598. if redactSecret {
  599. clientProxyURLRedacted = o.httpClientProxyURL.Redacted()
  600. } else {
  601. clientProxyURLRedacted = o.httpClientProxyURL.String()
  602. }
  603. }
  604. var clientProxyURLsRedacted string
  605. if len(o.httpClientProxies) > 0 {
  606. if redactSecret {
  607. var proxyURLs []string
  608. for range o.httpClientProxies {
  609. proxyURLs = append(proxyURLs, "<redacted>")
  610. }
  611. clientProxyURLsRedacted = strings.Join(proxyURLs, ",")
  612. } else {
  613. clientProxyURLsRedacted = strings.Join(o.httpClientProxies, ",")
  614. }
  615. }
  616. var mediaProxyPrivateKeyValue string
  617. if len(o.mediaProxyPrivateKey) > 0 {
  618. mediaProxyPrivateKeyValue = "<binary-data>"
  619. }
  620. var keyValues = map[string]interface{}{
  621. "ADMIN_PASSWORD": redactSecretValue(o.adminPassword, redactSecret),
  622. "ADMIN_USERNAME": o.adminUsername,
  623. "AUTH_PROXY_HEADER": o.authProxyHeader,
  624. "AUTH_PROXY_USER_CREATION": o.authProxyUserCreation,
  625. "BASE_PATH": o.basePath,
  626. "BASE_URL": o.baseURL,
  627. "BATCH_SIZE": o.batchSize,
  628. "CERT_DOMAIN": o.certDomain,
  629. "CERT_FILE": o.certFile,
  630. "CLEANUP_ARCHIVE_BATCH_SIZE": o.cleanupArchiveBatchSize,
  631. "CLEANUP_ARCHIVE_READ_DAYS": o.cleanupArchiveReadDays,
  632. "CLEANUP_ARCHIVE_UNREAD_DAYS": o.cleanupArchiveUnreadDays,
  633. "CLEANUP_FREQUENCY_HOURS": o.cleanupFrequencyHours,
  634. "CLEANUP_REMOVE_SESSIONS_DAYS": o.cleanupRemoveSessionsDays,
  635. "CREATE_ADMIN": o.createAdmin,
  636. "DATABASE_CONNECTION_LIFETIME": o.databaseConnectionLifetime,
  637. "DATABASE_MAX_CONNS": o.databaseMaxConns,
  638. "DATABASE_MIN_CONNS": o.databaseMinConns,
  639. "DATABASE_URL": redactSecretValue(o.databaseURL, redactSecret),
  640. "DISABLE_HSTS": !o.hsts,
  641. "DISABLE_HTTP_SERVICE": !o.httpService,
  642. "DISABLE_SCHEDULER_SERVICE": !o.schedulerService,
  643. "FILTER_ENTRY_MAX_AGE_DAYS": o.filterEntryMaxAgeDays,
  644. "FETCH_YOUTUBE_WATCH_TIME": o.fetchYouTubeWatchTime,
  645. "FETCH_NEBULA_WATCH_TIME": o.fetchNebulaWatchTime,
  646. "FETCH_ODYSEE_WATCH_TIME": o.fetchOdyseeWatchTime,
  647. "FETCH_BILIBILI_WATCH_TIME": o.fetchBilibiliWatchTime,
  648. "HTTPS": o.HTTPS,
  649. "HTTP_CLIENT_MAX_BODY_SIZE": o.httpClientMaxBodySize,
  650. "HTTP_CLIENT_PROXIES": clientProxyURLsRedacted,
  651. "HTTP_CLIENT_PROXY": clientProxyURLRedacted,
  652. "HTTP_CLIENT_TIMEOUT": o.httpClientTimeout,
  653. "HTTP_CLIENT_USER_AGENT": o.httpClientUserAgent,
  654. "HTTP_SERVER_TIMEOUT": o.httpServerTimeout,
  655. "HTTP_SERVICE": o.httpService,
  656. "INVIDIOUS_INSTANCE": o.invidiousInstance,
  657. "KEY_FILE": o.certKeyFile,
  658. "LISTEN_ADDR": o.listenAddr,
  659. "LOG_FILE": o.logFile,
  660. "LOG_DATE_TIME": o.logDateTime,
  661. "LOG_FORMAT": o.logFormat,
  662. "LOG_LEVEL": o.logLevel,
  663. "MAINTENANCE_MESSAGE": o.maintenanceMessage,
  664. "MAINTENANCE_MODE": o.maintenanceMode,
  665. "METRICS_ALLOWED_NETWORKS": strings.Join(o.metricsAllowedNetworks, ","),
  666. "METRICS_COLLECTOR": o.metricsCollector,
  667. "METRICS_PASSWORD": redactSecretValue(o.metricsPassword, redactSecret),
  668. "METRICS_REFRESH_INTERVAL": o.metricsRefreshInterval,
  669. "METRICS_USERNAME": o.metricsUsername,
  670. "OAUTH2_CLIENT_ID": o.oauth2ClientID,
  671. "OAUTH2_CLIENT_SECRET": redactSecretValue(o.oauth2ClientSecret, redactSecret),
  672. "OAUTH2_OIDC_DISCOVERY_ENDPOINT": o.oidcDiscoveryEndpoint,
  673. "OAUTH2_OIDC_PROVIDER_NAME": o.oidcProviderName,
  674. "OAUTH2_PROVIDER": o.oauth2Provider,
  675. "OAUTH2_REDIRECT_URL": o.oauth2RedirectURL,
  676. "OAUTH2_USER_CREATION": o.oauth2UserCreationAllowed,
  677. "DISABLE_LOCAL_AUTH": o.disableLocalAuth,
  678. "POCKET_CONSUMER_KEY": redactSecretValue(o.pocketConsumerKey, redactSecret),
  679. "POLLING_FREQUENCY": o.pollingFrequency,
  680. "FORCE_REFRESH_INTERVAL": o.forceRefreshInterval,
  681. "POLLING_PARSING_ERROR_LIMIT": o.pollingParsingErrorLimit,
  682. "POLLING_SCHEDULER": o.pollingScheduler,
  683. "MEDIA_PROXY_HTTP_CLIENT_TIMEOUT": o.mediaProxyHTTPClientTimeout,
  684. "MEDIA_PROXY_RESOURCE_TYPES": o.mediaProxyResourceTypes,
  685. "MEDIA_PROXY_MODE": o.mediaProxyMode,
  686. "MEDIA_PROXY_PRIVATE_KEY": mediaProxyPrivateKeyValue,
  687. "MEDIA_PROXY_CUSTOM_URL": o.mediaProxyCustomURL,
  688. "ROOT_URL": o.rootURL,
  689. "RUN_MIGRATIONS": o.runMigrations,
  690. "SCHEDULER_ENTRY_FREQUENCY_MAX_INTERVAL": o.schedulerEntryFrequencyMaxInterval,
  691. "SCHEDULER_ENTRY_FREQUENCY_MIN_INTERVAL": o.schedulerEntryFrequencyMinInterval,
  692. "SCHEDULER_ENTRY_FREQUENCY_FACTOR": o.schedulerEntryFrequencyFactor,
  693. "SCHEDULER_ROUND_ROBIN_MIN_INTERVAL": o.schedulerRoundRobinMinInterval,
  694. "SCHEDULER_ROUND_ROBIN_MAX_INTERVAL": o.schedulerRoundRobinMaxInterval,
  695. "SCHEDULER_SERVICE": o.schedulerService,
  696. "SERVER_TIMING_HEADER": o.serverTimingHeader,
  697. "WATCHDOG": o.watchdog,
  698. "WORKER_POOL_SIZE": o.workerPoolSize,
  699. "YOUTUBE_API_KEY": redactSecretValue(o.youTubeApiKey, redactSecret),
  700. "YOUTUBE_EMBED_URL_OVERRIDE": o.youTubeEmbedUrlOverride,
  701. "WEBAUTHN": o.webAuthn,
  702. }
  703. keys := make([]string, 0, len(keyValues))
  704. for key := range keyValues {
  705. keys = append(keys, key)
  706. }
  707. sort.Strings(keys)
  708. var sortedOptions []*Option
  709. for _, key := range keys {
  710. sortedOptions = append(sortedOptions, &Option{Key: key, Value: keyValues[key]})
  711. }
  712. return sortedOptions
  713. }
  714. func (o *Options) String() string {
  715. var builder strings.Builder
  716. for _, option := range o.SortedOptions(false) {
  717. fmt.Fprintf(&builder, "%s=%v\n", option.Key, option.Value)
  718. }
  719. return builder.String()
  720. }
  721. func redactSecretValue(value string, redactSecret bool) string {
  722. if redactSecret && value != "" {
  723. return "<secret>"
  724. }
  725. return value
  726. }