登录
目录
当前位置： 首页 > 文档资料 > Seafile 服务器用户手册 >

服务器个性化配置 - seahub_settings.py

优质
小牛编辑
150浏览
2023-12-01

Note: Seafile 服务器 5.0.0 之后，所有配置文件都移动到了统一的 conf 目录下。 了解详情.
提示：您还可以通过Web界面修改多说配置项。这些配置项会被保存在数据库表(seahub_db/constance_config)中。他们的优先级高于配置文件中的项目。如果要禁用Web界面设置，可以添加 ENABLE_SETTINGS_VIA_WEB = False 到 seahub_settings.py。

Seahub 下发送邮件提醒

请参看 发送邮件提醒

Memcached

Seahub 默认缓存文件系统上的缓存项(avatars,profiles,等)到(/tmp/seahub_cache)。您可以用Memcached替换。

请参考 “添加Memcached”

用户管理选项

以下选项影响用户注册，密码和会话。

  1. # 是否开启用户注册功能. 默认为 `False`.
  2. ENABLE_SIGNUP = False
  4. # 用户注册后是否立刻激活，默认为 `True`.
  5. # 如设置为 `False`, 需管理员手动激活.
  6. ACTIVATE_AFTER_REGISTRATION = False
  8. # 管理员新增用户后是否给用户发送邮件. 默认为 `True`.
  9. SEND_EMAIL_ON_ADDING_SYSTEM_MEMBER = True
  11. # 管理员重置用户密码后是否给用户发送邮件. 默认为 `True`.
  12. SEND_EMAIL_ON_RESETTING_USER_PASSWD = True
  14. # 新用户注册后，给管理员发送通知邮件。默认为 `False`。
  15. NOTIFY_ADMIN_AFTER_REGISTRATION = True
  17. # 登录记住天数. 默认 7 天
  18. LOGIN_REMEMBER_DAYS = 7
  20. # 用户输入密码错误次数超过改设置后，显示验证码
  21. LOGIN_ATTEMPT_LIMIT = 3
  23. # 如果登录密码输错次数超过 ``LOGIN_ATTEMPT_LIMIT``，冻结账号
  24. # since 5.1.2
  25. FREEZE_USER_ON_LOGIN_FAILED = False
  27. # 用户密码最少长度
  28. USER_PASSWORD_MIN_LENGTH = 6
  30. # 检查用户密码的复杂性
  31. USER_STRONG_PASSWORD_REQUIRED = False
  33. # 用户密码复杂性:
  34. #    数字, 大写字母, 小写字母, 其他符号
  35. # '3' 表示至少包含以上四种类型中的 3 个
  36. USER_PASSWORD_STRENGTH_LEVEL = 3
  38. # 管理员添加／重置用户后，强制用户修改登录密码
  39. # 在版本 5.1.1 加入, 默认开启
  40. FORCE_PASSWORD_CHANGE = True
  42. # cookie 的保存时限，(默认为 2 周).
  43. SESSION_COOKIE_AGE = 60 * 60 * 24 * 7 * 2
  45. # 浏览器关闭后，是否清空用户会话 cookie
  46. SESSION_EXPIRE_AT_BROWSER_CLOSE = False
  48. # 是否存储每次请求的会话数据. 默认为 `False`
  49. SESSION_SAVE_EVERY_REQUEST = False
  51. # 是否开启个人wiki和群组wiki。默认是 `False`
  52. # Since 6.1.0
  53. ENABLE_WIKI = True

资料库设置

  1. # 加密资料库密码最小长度
  2. REPO_PASSWORD_MIN_LENGTH = 8
  4. # 加密外链密码最小长度
  5. SHARE_LINK_PASSWORD_MIN_LENGTH = 8
  7. # 关闭与任意目录同步的功能
  8. DISABLE_SYNC_WITH_ANY_FOLDER = True
  10. # 允许用户设置资料库的历史保留天数
  11. ENABLE_REPO_HISTORY_SETTING = True
  13. # 是否允许普通用户创建组织资料库
  14. # Since version 5.0.5
  15. ENABLE_USER_CREATE_ORG_REPO = True

在线文件查看设置

  1. # 是否使用 pdf.js 来在线查看文件. 默认为 `True`
  2. USE_PDFJS = True
  4. # 在线文件查看最大文件大小，默认为 30M.
  5. # 注意, 在专业版中，seafevents.conf 中有另一个选项
  6. # `max-size` 也控制 doc/ppt/excel/pdf 文件在线查看的最大文件大小。
  7. # 您需要同时把这两个选项调大，如果您要允许 30M 以上 doc/ppt/excel/pdf 的查看。
  8. FILE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
  10. # 扩展预览文本文件
  11. # 注意：Since version 6.1.1
  12. TEXT_PREVIEW_EXT = """ac, am, bat, c, cc, cmake, cpp, cs, css, diff, el, h, html,
  13. htm, java, js, json, less, make, org, php, pl, properties, py, rb,
  14. scala, script, sh, sql, txt, text, tex, vi, vim, xhtml, xml, log, csv,
  15. groovy, rst, patch, go"""
  17. # 开启 thumbnails 功能
  18. # 注意: since version 4.0.2
  19. ENABLE_THUMBNAIL = True
  21. # 对于小于以下尺寸的图片，seafile只能生成缩略图
  22. THUMBNAIL_IMAGE_SIZE_LIMIT = 30 # MB
  24. # 文件缩略图的存储位置
  25. THUMBNAIL_ROOT = '/haiwen/seahub-data/thumbnail/thumb/'
  27. # 开启或禁用视频缩略图，ffmpeg 和 moviepy 应该事先被安装
  28. # 详情,请参阅https://manual.seafile.com/deploy/video_thumbnails.html
  29. # NOTE: since version 6.1
  30. ENABLE_VIDEO_THUMBNAIL = False
  32. # 使用第5秒的图片作为缩略图
  33. THUMBNAIL_VIDEO_FRAME_TIME = 5 
  35. # 图片预览的默认大小。放大这个尺寸可以提高预览的质量。
  36. # 注意: since version 6.1.1
  37. THUMBNAIL_SIZE_FOR_ORIGINAL = 1024

Cloud 模式

如果您使用的是一个基于未知用户的seafile，那么您应该启用 Cloud 模式。它禁用了seafile网站上的”组织”标签，以确保用户不能访问用户列表。Cloud 模式提供了一些不错的功能，比如与未注册用户共享内容，并向他们发送邀请。因此，您还需要启用用户注册。通过全局通讯录(从4.2.3版本后)，您可以搜索每个用户账户。所以您可能想要禁用它。

  1. # Enable cloude mode and hide `Organization` tab.
  2. CLOUD_MODE = True
  4. # Disable global address book
  5. ENABLE_GLOBAL_ADDRESSBOOK = False

外部认证

  1. # Enable authentication with ADFS
  2. # Default is False
  3. # Since 6.0.9
  4. ENABLE_ADFS_LOGIN = True
  6. # Enable authentication wit Kerberos
  7. # Default is False
  8. ENABLE_KRB5_LOGIN = True
  10. # Enable authentication with Shibboleth
  11. # Default is False
  12. ENABLE_SHIBBOLETH_LOGIN = True

其他选项

  1. # Disable settings via Web interface in system admin->settings
  2. # Default is True
  3. # Since 5.1.3
  4. ENABLE_SETTINGS_VIA_WEB = False
  6. # Choices can be found here:
  7. # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
  8. # although not all choices may be available on all operating systems.
  9. # If running in a Windows environment this must be set to the same as your
  10. # system time zone.
  11. TIME_ZONE = 'UTC'
  13. # Language code for this installation. All choices can be found here:
  14. # http://www.i18nguy.com/unicode/language-identifiers.html
  15. # Default language for sending emails.
  16. LANGUAGE_CODE = 'en'
  18. # Set this to your website/company's name. This is contained in email notifications and welcome message when user login for the first time.
  19. SITE_NAME = 'Seafile'
  21. # Browser tab's title
  22. SITE_TITLE = 'Private Seafile'
  24. # If you don't want to run seahub website on your site's root path, set this option to your preferred path.
  25. # e.g. setting it to '/seahub/' would run seahub on http://example.com/seahub/.
  26. SITE_ROOT = '/'
  28. # Max number of files when user upload file/folder.
  29. # Since version 6.0.4
  30. MAX_NUMBER_OF_FILES_FOR_FILEUPLOAD = 500
  32. # Control the language that send email. Default to user's current language.
  33. # Since version 6.1.1
  34. SHARE_LINK_EMAIL_LANGUAGE = ''
  36. # Interval for browser requests unread notifications
  37. # Since PRO 6.1.4 or CE 6.1.2
  38. UNREAD_NOTIFICATIONS_REQUEST_INTERVAL = 3 * 60 # seconds

专业版选项

  1. # Whether to show the used traffic in user's profile popup dialog. Default is True
  2. SHOW_TRAFFIC = True
  4. # Allow administrator to view user's file in UNENCRYPTED libraries
  5. # through Libraries page in System Admin. Default is False.
  6. ENABLE_SYS_ADMIN_VIEW_REPO = True
  8. # For un-login users, providing an email before downloading or uploading on shared link page.
  9. # Since version 5.1.4
  10. ENABLE_SHARE_LINK_AUDIT = True
  12. # Check virus after upload files to shared upload links. Defaults to `False`.
  13. # Since version 6.0
  14. ENABLE_UPLOAD_LINK_VIRUS_CHECK = True
  16. # Enable system admin add T&C, all users need to accept terms before using. Defaults to `False`.
  17. # Since version 6.0
  18. ENABLE_TERMS_AND_CONDITIONS = True
  20. # Enable two factor authentication for accounts. Defaults to `False`.
  21. # Since version 6.0
  22. ENABLE_TWO_FACTOR_AUTH = True
  24. # Enable user select a template when he/she creates library.
  25. # When user select a template, Seafile will create folders releated to the pattern automaticly.
  26. # Since version 6.0
  27. LIBRARY_TEMPLATES = {
  28.     'Technology': ['/Develop/Python', '/Test'],
  29.     'Finance': ['/Current assets', '/Fixed assets/Computer']
  30. }
  32. # Send email to these email addresses when a virus is detected.
  33. # This list can be any valid email address, not necessarily the emails of Seafile user.
  34. # Since version 6.0.8
  35. VIRUS_SCAN_NOTIFY_LIST = ['user_a@seafile.com', 'user_b@seafile.com']

RESTful API

  1. # API throttling 相关配置。如果api的返回码为429，可以调高下面的数值。
  2. REST_FRAMEWORK = {
  3.     'DEFAULT_THROTTLE_RATES': {
  4.         'ping': '600/minute',
  5.         'anon': '5/minute',
  6.         'user': '300/minute',
  7.     },
  8.     'UNICODE_JSON': False,
  9. }
  11. # Throtting 白名单，用来忽略特定IP。
  12. # e.g. REST_FRAMEWORK_THROTTING_WHITELIST = ['127.0.0.1', '192.168.1.1']
  13. # 请确保 `REMOTE_ADDR` 头部在 Nginx 配置了，具体参考 https://manual.seafile.com/deploy/deploy_with_nginx.html 
  14. REST_FRAMEWORK_THROTTING_WHITELIST = []

注意

  • 请重启 Seahub 以使更改生效.
  • 如果更改没有生效，请删除 seahub_setting.pyc 缓存文件.
  • 如果需要在 seahub_settings.py 里添加中文注释，请把 # -*- coding: utf-8 -*- 写入文件第一行，并单独为一行。
  1. ./seahub.sh restart
免责声明： 以上内容版权归原作者所有，如有侵犯您的原创版权请告知，我们将尽快删除相关内容。感谢每一位辛勤著写的作者，感谢每一位的分享。
@小牛知识库 xnip.cn