Skip to content
A fast and lightweight blog framework based on Python3 development
Python Shell Dockerfile
Branch: master
Clone or download
Latest commit c01743c Sep 17, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.develop 修改docker脚本 Jun 18, 2019
.github Create FUNDING.yml Sep 17, 2019
.reall_network Update .gitlab-ci.yml Jun 18, 2019
common 修改加载方法 Jun 18, 2019
example 修改docker Jun 18, 2019
install 修改引用方法 Jun 18, 2019
manage 修改安装脚本 Jun 18, 2019
upgrade 修改升级脚本 Jun 18, 2019
.gitignore 修改demo构建方法,修改nginx构建工具 Apr 14, 2019
LICENSE Update LICENSE Nov 9, 2017
README.md 修改许可证位置 May 30, 2019
control_server.py 修改提示语言 May 6, 2019
init.py 修改调试时静态文件的目录 May 10, 2019
manage.py 修改提示语言 May 6, 2019
watch.py 修改拉取方法 Apr 26, 2019

README.md

SilverBlog

License

FOSSA Status

中文版本

SilverBlog is a lightweight blog project based on Python3.

Why SilverBlog

  • Simple, compact blog system.
  • Easy to install and deploy.
  • Complete Rss support.
  • Modular design, easy to add, delete.
  • No database design.
  • With a static page generation module comparable to Hexo, you can run on Github Page with only one line of commands.
  • Native support for Linux can be deployed on any platform through Docker.
  • Has Android, IOS, WEB client.
  • Full GitHub Flavored Markdown support

How to install

We support freebsd,debian(ubuntu), fedora, alpine, arch linux for direct deployment. For other systems, please use Docker deployment. You can install SilverBlog directly using the installation script:

bash -c "$(curl -fsSL https://get.silverblog.org/master/install/install.sh)"

Custom installation name:

bash -c "$(curl -fsSL https://get.silverblog.org/master/install/install.sh)" -n silverblog

Docker:

bash -c "$(curl -fsSL https://get.silverblog.org/master/install/docker_install.sh)"

If you are using a new install of Ubuntu 18.04, you may need to modify the /etc/apt/source.list file and add universe and multiverse software sources after main, which will ensure the installation will run smoothly. A correct configuration is as follows:

deb http://archive.ubuntu.com/ubuntu bionic main restricted universe multiverse

deb http://archive.ubuntu.com/ubuntu/ bionic-updates main restricted universe multiverse

deb http://archive.ubuntu.com/ubuntu/ bionic-backports main restricted universe multiverse

deb http://security.ubuntu.com/ubuntu bionic-security main restricted universe multiverse

You can select a theme in silverblog-theme, then use ./manage.py to install the configuration and configure it correctly in the configuration file below.

This installation script uses the nginx + uwsgi execution mode by default. You can put the auto-generated nginx_config file into your nginx package's website configuration directory. If you need to use a third-party web client, don't forget to modify the CORS configuration in nginx_config.

wiki

Start operation

You can run SilverBlog using tools such as Tmux or Screen. You just need to execute python3 watch.py to open your blog.

You can use the --control parameter to run the management server.

If you need to run blogs and manage servers simultaneously in a container, use the python3 watch.py ​​--control --docker command. We do not recommend this method of operation if conditions permit.

Keep running and monitoring your blog

Containers started with docker-compose are automatically restarted. You just need to ensure that the Docker service starts automatically when it starts up.

You can configure your server using the systemd_install.sh file in the install directory, which requires root privileges. It is consistent with the recommended method below.

bash systemd_install.sh

custom:

bash systemd_install.sh -n silverblog -u silverblog

SilverBlog recommends using a NodeJS-based monitor: pm2

For the installation of pm2 see tj/n: Node version management and pm2 - Quick Start

you just have to run:

pm2 start pm2.json

It is possible to automatically restart SilverBlog after updating files or program errors.

You can also use:

pm2 startup
pm2 save

Enables your SilverBlog to start automatically when the system is powered on.

How to use administrative scripts

You can use ./manage.py -h at any time to get the help information for the SilverBlog management module.

Directly typing ./manage.py will enter the whiptail build's graphical environment.

Using the github page feature

You can use git clone https://${personal_access_tokens}@github.com/${your_repo} static_page to initialize your Github Page repository.

Don't forget to initialize your submit user information using the following command:

cd static_page
git config user.email "youremail@google.com"
git config user.name "your name"

Next, you just need to execute the Build static page command. The system will automatically generate a static page and submit it to the github page.

You can try using the /example/.travis.yml script for automated submission.

Use client management server

Warning! If you need to use the SilverBlog client, make sure you use the https security protocol. Using http is like telling a password to a hacker! This may compromise your server security!

You can download the latest android client at https://github.com/SilverBlog/SilverBlog_Android/releases.

You can compile and deploy the https://github.com/SilverBlog/silverblog_ios IOS client yourself.

You can use SilverCreator (https://c.silverblog.org) to manage your blog.

You can execute ./manage.py qrcode to generate the automated configuration QR code.

Switch to developer preview

SilverBlog is now available as a developer preview version. You can switch from git checkout --track -b origin/develop to the developer preview in the repository root directory. This version may have undiscovered bugs. Please use it with caution.

Participate in development

We welcome you to report issue or pull request on GitHub of the SilverBlog project.

If you are not yet familiar with GitHub's Fork and Pull development model, you can read the GitHub Documentation for more information.

We recommend that you use the Chinese language to raise an issue, and attach an English translation below to make it easier for non-Chinese native language developers to read and understand.

Thanks

Thanks to @Liqueur Librazy for providing the demo program server for this project.

Thanks Jetbrains for providing a free All product IDE for this project

Give a cup of coffee and let me better maintain this project?

Your donation will make me work better for this project.

You can’t perform that action at this time.