DjangoBB论坛搭建

迷南。 2022-07-14 02:29 333阅读 0赞

DjangoBB论坛，是基于Django（Python经典框架）进行修改，其安装部署需要依赖于python和Django。很多资料上都是说明采用python的virtualenv，virtualenv就是python的一个虚拟沙盒，用于各项目的隔离。我觉得用不用无所谓。

一、环境准备：

本文使用的操作系统是CentOS7虚拟机。Windows和Ubuntu应该类似，无非依赖的包及依赖的编译环境有差异。

1、基础环境版本

  • CentOS 7
  • Python 2.7/3.3+
  • Django >= 1.7

以下操作都是用的root账号，如果不是root用户，请在命令前家“sudo”

2、软件安装

（1）安装python

  1. yum install -y python

验证是否安装成功

  1. python --version

正确显示版本号，即安装成功。

（2）安装pip

首先，需要安装扩展原EPEL。EPEL(http://fedoraproject.org/wiki/EPEL) 是由 Fedora 社区打造，为 RHEL 及衍生发行版如 CentOS、Scientific Linux 等提供高质量软件包的项目。

  1. yum -y install epel-release

然后，安装pip

  1. yum -y install python-pip

验证是否安装成功

  1. pip --version

正确显示版本号，即安装成功。

默认的pip使用的是低版本，可以使用下面命令更新pip

  1. pip install -U pip

二、DjangoBB搭建

（1）下载源代码

要搭建DjangoBB，需要从git或hg上，下载两个工程的代码。这主要是由于Django框架本身，有project和app的概念。具体区别，请翻阅参考资料9。

  1. wget https://bitbucket.org/slav0nic/djangobb/get/stable.tar.gz
  2. wget https://bitbucket.org/slav0nic/djangobb_project/get/tip.tar.gz

注：最好到上面的https://bitbucket.org中（JIRA同一家公司开发的类似于github的网站），找到最新版本的包来下载。

下载完成之后，可以通过下面的命令，在根目录下找到下载的包。

  1. ls -l
  3. stable.tar.gz
  4. tip.tar.gz

（2）解压缩和重命名已下载的包

  1. tar zxvf stable.tar.gz
  2. tar zxvf tip.tar.gz

解压后的目录名称与下载的包名不同，而且会很长不方便操作。改个短小的名字，方面操作。我们把：
- stable.tar.gz:解压后的目录改为djangobb-master
- tip.tar.gz:解压后的目录改为djangobb-project

  1. ls -l
  3. mv slav0nic-djangobb-bfcdda967701 djangobb-master
  4. mv slav0nic-djangobb_project-8087a7e42207 djangobb-project

（3）安装默认依赖包

进入到djangobb-master目录

  1. cd djangobb-master

该目录下有三个以requirements开头的txt文件，这些文件中包含所需使用的依赖包。
- requirements.txt
- requirements_optional.txt
- requirements_dev.txt（开发用的依赖，搭建环境用不到）

  1. pip install -r requirements.txt
  2. pip install -r requirements_optional.txt

注：以上是自动安装的方式，这种方式有时可能会因为网络等问题卡住或者出错，所以可以选择提前手动安装。打开requirements.txt，查看里面的依赖包，用 pip install 一条一条执行。

（4）安装其它依赖包

除了requirements中的包以外，还有几个Django依赖的额外的包需要安装。

  1. pip install whoosh
  2. pip install django-mailer
  3. pip install django-nocaptcha-recaptcha
  4. pip install django-pagination-py3
  5. pip install django-static-sitemaps
  7. 或者
  9. pip install whoosh django-mailer django-nocaptcha-recaptcha django-pagination-py3 django-static-sitemaps

安装完成后，可以通过下面命令查看，已安装的包

  1. pip list

不合适的包可以用下面命令删除

  1. pip uninstall <packagename>

（5）创建Django工程

切换到根目录

  1. cd ~
  3. 或
  5. cd /root

创建Django工程，本例中使用的工程名为“luntan”

  1. django-admin startproject luntan

工程创建好之后，可以通过以下命令进入：

  1. cd ~/luntan
  3. 或
  5. cd /root/luntan

注：Django工程创建好之后，会新建一个luntan目录，在该目录下还有一个luntan目录。为了区别，后面在说明的时候，会用 ~/luntan 代表第一层目录，~/luntan/luntan 代表第二层目录。

（6）拷贝资源文件

进入到djangobb-master目录下，将其中的djangobb_forum文件夹复制到~/luntan 目录下

  1. [root@nx-centos7 ~]# cd ~/djangobb-master
  4. [root@nx-centos7 djangobb-master]# cp -r djangobb_forum ~/luntan

进入到djangobb-project/basic_project目录下，其中会包含系统用到的资源文件，将其中的djangobb_index,media,project_static,static,templates和文件forms.py复制到 ~/luntan 目录下

  1. [root@nx-centos7 ~]# cd ~/djangobb-project/basic_project/
  4. [root@nx-centos7 basic_project]# cp -r djangobb_index ~/luntan
  5. [root@nx-centos7 basic_project]# cp -r media ~/luntan
  6. [root@nx-centos7 basic_project]# cp -r project_static ~/luntan/luntan
  7. [root@nx-centos7 basic_project]# cp -r static ~/luntan
  8. [root@nx-centos7 basic_project]# cp -r templates ~/luntan
  9. [root@nx-centos7 basic_project]# cp -r forms.py ~/luntan

（7）拷贝配置文件

djangobb-project/basic_project目录下，除了上一步包含的资源文件外，还包含两个配置文件settings.py和urls.py。将这两个文件拷贝到 ~/luntan/luntan 目录下

  1. [root@nx-centos7 basic_project]# cp -r urls.py ~/luntan/luntan
  2. cp: overwrite ‘~/luntan/luntan/urls.py’? y
  3. [root@nx-centos7 basic_project]# cp -r settings.py ~/luntan/luntan
  4. cp: overwrite ‘~/luntan/luntan/settings.py’? y

（8）修改配置文件

进入到 ~/luntan/luntan 目录下，修改 settings.py 配置文件。部署成功配置文件示例如下：

  1. # -*- coding: utf-8 -*-
  2. import os.path
  4. PROJECT_ROOT = os.path.dirname(os.path.realpath(__file__))
  6. DEBUG = True
  7. ALLOWED_HOSTS = ['*']
  9. ADMINS = (
  10.     # ('Your Name', 'your_email@domain.com'),
  11. )
  13. MANAGERS = ADMINS
  15. DATABASES = {
  16.     'default': {
  17.         'ENGINE': 'django.db.backends.sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
  18.         'NAME': os.path.join(PROJECT_ROOT,'db.sqlite3'),                      # Or path to database file if using sqlite3.
  19.         'USER': '',                      # Not used with sqlite3.
  20.         'PASSWORD': '',                  # Not used with sqlite3.
  21.         'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
  22.         'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
  23.     }
  24. }
  26. # Local time zone for this installation. Choices can be found here:
  27. # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
  28. # although not all choices may be available on all operating systems.
  29. # If running in a Windows environment this must be set to the same as your
  30. # system time zone.
  31. TIME_ZONE = 'Asia/Shanghai'
  32. USE_TZ = True
  34. # Language code for this installation. All choices can be found here:
  35. # http://www.i18nguy.com/unicode/language-identifiers.html
  36. LANGUAGE_CODE = 'zh-cn'
  38. LANGUAGES = (
  39.     ('ca', 'Catalan'),
  40.     ('cs', 'Czech'),
  41.     ('de', 'German'),
  42.     ('en', 'English'),
  43.     ('es', 'Spanish'),
  44.     ('fo', 'Faroese'),
  45.     ('fr', 'France'),
  46.     ('it', 'Italian'),
  47.     ('lt', 'Lithuanian'),
  48.     ('mn', 'Mongolian'),
  49.     ('nl', 'Dutch'),
  50.     ('pl', 'Polish'),
  51.     ('ru', 'Russian'),
  52.     ('uk_UA', 'Ukrainian'),
  53.     ('vi', 'Vietnamese'),
  54.     ('zh_CN', 'Chinese'),
  55. )
  57. SITE_ID = 1
  59. # If you set this to False, Django will make some optimizations so as not
  60. # to load the internationalization machinery.
  61. USE_I18N = True
  62. # If you set this to False, Django will not format dates, numbers and
  63. # calendars according to the current locale
  64. USE_L10N = True
  66. # Absolute filesystem path to the directory that will hold user-uploaded files.
  67. # Example: "/home/media/media.lawrence.com/media/"
  68. MEDIA_ROOT = os.path.join(PROJECT_ROOT, 'media')
  70. # URL that handles the media served from MEDIA_ROOT. Make sure to use a
  71. # trailing slash.
  72. # Examples: "http://media.lawrence.com/media/", "http://example.com/media/"
  73. MEDIA_URL = '/media/'
  75. # Absolute path to the directory static files should be collected to.
  76. # Don't put anything in this directory yourself; store your static files
  77. # in apps' "static/" subdirectories and in STATICFILES_DIRS.
  78. # Example: "/home/media/media.lawrence.com/static/"
  79. STATIC_ROOT = os.path.join(PROJECT_ROOT, 'static')
  81. # URL prefix for static files.
  82. # Example: "http://media.lawrence.com/static/"
  83. STATIC_URL = '/static/'
  85. # Additional locations of static files
  86. STATICFILES_DIRS = (
  87.     os.path.join(PROJECT_ROOT,'project_static'),
  88. )
  90. # List of finder classes that know how to find static files in
  91. # various locations.
  92. STATICFILES_FINDERS = (
  93.     'django.contrib.staticfiles.finders.FileSystemFinder',
  94.     'django.contrib.staticfiles.finders.AppDirectoriesFinder',
  95. #    'django.contrib.staticfiles.finders.DefaultStorageFinder',
  96. )
  98. # Make this unique, and don't share it with anybody.
  100. if not hasattr(globals(), 'SECRET_KEY'):
  101.     SECRET_FILE = os.path.join(PROJECT_ROOT, 'secret.txt')
  102.     try:
  103.         SECRET_KEY = open(SECRET_FILE).read().strip()
  104.     except IOError:
  105.         try:
  106.             from random import choice
  107.             import string
  108.             symbols = ''.join((string.lowercase, string.digits, string.punctuation ))
  109.             SECRET_KEY = ''.join([choice(symbols) for i in range(50)])
  110.             secret = file(SECRET_FILE, 'w')
  111.             secret.write(SECRET_KEY)
  112.             secret.close()
  113.         except IOError:
  114.             raise Exception('Please create a %s file with random characters to generate your secret key!' % SECRET_FILE)
  118. MIDDLEWARE_CLASSES = (
  119.     'django.middleware.cache.UpdateCacheMiddleware',
  120.     'django.middleware.common.CommonMiddleware',
  121.     'django.contrib.sessions.middleware.SessionMiddleware',
  122.     'django.middleware.csrf.CsrfViewMiddleware',
  123.     'django.contrib.auth.middleware.AuthenticationMiddleware',
  124.     'django.contrib.messages.middleware.MessageMiddleware',
  125.     'django.middleware.locale.LocaleMiddleware',
  126.     'django.middleware.cache.FetchFromCacheMiddleware',
  128.     'djangobb_forum.middleware.LastLoginMiddleware',
  129.     'djangobb_forum.middleware.UsersOnline',
  130.     'djangobb_forum.middleware.TimezoneMiddleware',
  131. )
  133. ROOT_URLCONF = 'luntan.urls'
  136. TEMPLATES = [
  137.     {
  138.         'BACKEND': 'django.template.backends.django.DjangoTemplates',
  139.         'DIRS': [os.path.join(PROJECT_ROOT, 'templates')],
  140.         'OPTIONS': {
  141.             'context_processors': ['django.contrib.auth.context_processors.auth',
  142.                                    'django.template.context_processors.debug',
  143.                                    'django.template.context_processors.i18n',
  144.                                    'django.template.context_processors.media',
  145.                                    'django.template.context_processors.static',
  146.                                    'django.template.context_processors.request',
  147.                                    'django.contrib.messages.context_processors.messages',
  149.                                    'django_messages.context_processors.inbox',
  151.                                    'djangobb_forum.context_processors.forum_settings',
  152.                                    ],
  153.             'loaders': [
  154.                 'django.template.loaders.filesystem.Loader',
  155.                 'django.template.loaders.app_directories.Loader',
  156.                 'django.template.loaders.eggs.Loader',
  157.             ]
  158.         },
  159.     },
  160. ]
  162. INSTALLED_APPS = (
  163.     'django.contrib.auth',
  164.     'django.contrib.contenttypes',
  165.     'django.contrib.sessions',
  166.     'django.contrib.sites',
  167.     'django.contrib.messages',
  168.     'django.contrib.staticfiles',
  169.     'django.contrib.sitemaps',
  170.     'django.contrib.admin',
  171.     'django.contrib.admindocs',
  172.     'django.contrib.humanize',
  174.     'allauth',
  175.     'allauth.account',
  176.     'allauth.socialaccount',
  177.     'allauth.socialaccount.providers.openid',
  178.     'allauth.socialaccount.providers.google',
  179.     'allauth.socialaccount.providers.github',
  180.     'allauth.socialaccount.providers.twitter',
  182.     'haystack',
  183.     'django_messages',
  184.     'nocaptcha_recaptcha',
  186.     'djangobb_forum',
  187. )
  189. # A sample logging configuration. The only tangible logging
  190. # performed by this configuration is to send an email to
  191. # the site admins on every HTTP 500 error when DEBUG=False.
  192. # See http://docs.djangoproject.com/en/dev/topics/logging for
  193. # more details on how to customize your logging configuration.
  194. LOGGING = {
  195.     'version': 1,
  196.     'disable_existing_loggers': False,
  197.     'filters': {
  198.         'require_debug_false': {
  199.             '()': 'django.utils.log.RequireDebugFalse'
  200.         }
  201.     },
  202.     'handlers': {
  203.         'mail_admins': {
  204.             'level': 'ERROR',
  205.             'filters': ['require_debug_false'],
  206.             'class': 'django.utils.log.AdminEmailHandler'
  207.         }
  208.     },
  209.     'loggers': {
  210.         'django.request': {
  211.             'handlers': ['mail_admins'],
  212.             'level': 'ERROR',
  213.             'propagate': True,
  214.         },
  215.     }
  216. }
  218. try:
  219.     import mailer
  220.     INSTALLED_APPS += ('mailer',)
  221.     EMAIL_BACKEND = "mailer.backend.DbBackend"
  222. except ImportError:
  223.     pass
  226. FORCE_SCRIPT_NAME = ''
  228. # Haystack settings
  229. HAYSTACK_CONNECTIONS = {
  230.     'default': {
  231.         'ENGINE': 'haystack.backends.whoosh_backend.WhooshEngine',
  232.         'PATH': os.path.join(PROJECT_ROOT, 'djangobb_index'),
  233.         'INCLUDE_SPELLING': True,
  234.     },
  235. }
  236. HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
  238. # Account settings
  239. ACCOUNT_ACTIVATION_DAYS = 10
  240. LOGIN_REDIRECT_URL = '/forum/'
  241. LOGIN_URL = '/forum/account/signin/'
  242. AUTHENTICATION_BACKENDS = (
  243.     'django.contrib.auth.backends.ModelBackend',
  244.     'allauth.account.auth_backends.AuthenticationBackend',
  245. )
  247. # Cache settings
  248. CACHE_MIDDLEWARE_ANONYMOUS_ONLY = True
  250. # Allauth
  251. ACCOUNT_LOGOUT_ON_GET = True
  252. ACCOUNT_EMAIL_REQUIRED = True
  253. ACCOUNT_SIGNUP_FORM_CLASS = 'forms.SignupForm'
  255. try:
  256.     from local_settings import *
  257. except ImportError:
  258.     pass

主要修改内容：

1、修改数据库

为了方便，本例中使用的是sqlite3数据库，如果在安装过程发现生成有问题，应该是python环境中没有sqlite，可以提前用命令进行安装。

  1. yum install sqlite-devel

修改内容

  1. DATABASES = {
  2.     'default': {
  3.         'ENGINE': 'django.db.backends.sqlite3', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
  4.         'NAME': os.path.join(PROJECT_ROOT,'db.sqlite3'),                      # Or path to database file if using sqlite3.
  5.         'USER': '',                      # Not used with sqlite3.
  6.         'PASSWORD': '',                  # Not used with sqlite3.
  7.         'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
  8.         'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
  9.     }
  10. }

在ENGINE属性中，增加数据库类型，然后补充其他属性。如果是使用sqlite，在NAME属性中，指定数据库生成的路径和文件名，如上例。

2、修改时区和国际化

  1. # Local time zone for this installation. Choices can be found here:
  2. # http://en.wikipedia.org/wiki/List_of_tz_zones_by_name
  3. # although not all choices may be available on all operating systems.
  4. # If running in a Windows environment this must be set to the same as your
  5. # system time zone.
  6. TIME_ZONE = 'Asia/Shanghai'
  7. USE_TZ = True
  9. # Language code for this installation. All choices can be found here:
  10. # http://www.i18nguy.com/unicode/language-identifiers.html
  11. LANGUAGE_CODE = 'zh-cn'

3、修改ROOT URL

  1. ROOT_URLCONF = 'luntan.urls'

这里的 luntan 就是我们用Django建立的工程名。

4、访问安全控制

增加下面属性

  1. ALLOWED_HOSTS = ['*']

“*”代表全部，也可以指定具体IP。

（9）执行命令

以上配置完成之后，就可以执行相关的命令，进行部署。进入到 ~/luntan 目录下，这个目录下有一个 manage.py 文件，这个文件是所有命令执行的主体。该文件包含很多可执行的命令，可以通过下面命令来查看：

  1. ./manage.py --help

我们下面执行的命令只是一些必须的命令：

1、
切换到~/luntan/djangobb_forum目录下,在终端中输入如下指令编译message文件

  1. cd ~/luntan/djangobb_forum
  3. django-admin compilemessages

2、切换到~/luntan目录下

  1. ./manage.py migrate

注：在执行这个命令的时候，有时会出错，错误信息中指明：在django_messages中引用了过时的patterns包，有RemovedInDjango110Warning。解决办法：（1）打卡错误提示中的XXX/django_messages/urls.py文件。（2）去掉文件中对patterns包的imports。（3）将 XXX = patterns（‘’，url。。），修改为 XXX = [url。。]。参考6

3、
切换到~/luntan目录，执行以下两个命令：

  1. ./manage.py collectstatic
  2. ./manage.py createsuperuser

（10）运行系统

  1. ./manage.py runserver 0.0.0.0:8000

注：（1）指定 0.0.0.0:8000，是为了保证可以在局域网中访问到该论坛。（2）如果要停止系统，必须使用 CTRL+C ，否则系统不会停止还会占用端口，只能用Kill命令杀掉进程。

在浏览器中输入访问论坛:
127.0.0.1:8000/forum/
在浏览器中输入如下地址用之前创建的管理账号登陆对论坛进行管理：
127.0.0.1:8000/admin/

参考资料：

[1]:https://bitbucket.org/slav0nic/djangobb/src
[2]:http://blog.csdn.net/lcyfire/article/details/52141079
[3]:http://blog.csdn.net/onepiece_dn/article/details/46229329
[4]:http://blog.csdn.net/tanzuozhev/article/details/50477711
[5]:http://blog.csdn.net/chenggong2dm/article/details/50457733
[6]:http://www.ziqiangxuetang.com/django/django-settings.html
[7]:http://blog.chinaunix.net/uid-21633169-id-4352454.html
[8]:https://github.com/LLK/s2forums
[9]:http://blog.csdn.net/jiwang1990/article/details/9374855

发表评论

表情：
评论列表 （有 0 条评论，333人围观）

还没有评论，来说两句吧...

相关阅读

    相关 DjangoBB论坛搭建

    DjangoBB论坛，是基于Django（Python经典框架）进行修改，其安装部署需要依赖于python和Django。很多资料上都是说明采用python的virtualen

    迷南。迷南。/ 0 赞/ 334 阅读