This repository has been archived by the owner. It is now read-only.
💐Rabbit | Beego Simple Web| Easy use for everyone🐰
Switch branches/tags
Clone or download
Latest commit 87277c1 Aug 15, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
Godeps update code and add front comment code Jan 3, 2018
conf bug fix Apr 22, 2018
controllers new v2.0 Apr 21, 2018
doc real ip Jan 5, 2018
file red Apr 20, 2018
lib real ip Jan 5, 2018
models default times zone is utc May 28, 2018
routers update name: rabbit Dec 13, 2017
static bug fix Apr 22, 2018
vendor update code and add front comment code Jan 3, 2018
views bug fix Apr 22, 2018
.gitignore red Apr 20, 2018
LICENSE Initial commit Mar 18, 2017 bu yao tai si li Aug 15, 2018
favicon.ico prepare to shift Apr 2, 2017
main.go v2.0start Apr 20, 2018
tuzi.png prepare to shift Apr 2, 2017

Project: Rabbit(Tuzi)

GitHub forks GitHub stars GitHub last commit Go Report Card GitHub issues GitHub license

请看: 中文介绍

You can own a enterprise web just listen to me! You just need install golang environment(ask for google help).Under developing...


1. How to use

Go1.9+ Must!

Just do this:

go get -v


git clone
mkdir -p %GOPATH%/src/
mv rabbit %GOPATH%/src/

Then build our web

go build

Before run, Please config the db set in conf/app.conf, use Mysql(install can ask google help)

# you can set it into prod when in production environment
runmode = dev

httpport = 8080
db_host =
db_port = 3306
db_user = root
db_pass = root
db_name = tuzi
db_type = mysql

EnableGzip = true
httpport = 80
db_host =
db_port = 3306
db_user = root
db_pass = root
db_name = tuzi
db_type = mysql

And init our database:

./rabbit -db=1

Or(I recommend to use)

cd doc
cd sh
./ tuzi

tuzi is your db name, script equal to mysql -uroot -p -v tuzi < init.sql

Last run it:


Ok, you can open, Login to edit the website:, User: admin, Password:admin

if upload file error please make a new dir names file under this project:

# if in linux
mkdir file
chmod 777 file

2. How to Develop

a. Project Structure(modularization)

    ----conf config module

        ----app.conf 		app config file
        ----local_**.ini 	internationalization file

    ----controllers   controllers module
        ----admin	  back-end
            ----blog  blog-edit(category/paper) module
            ----rbac  authority module
        ----home 	front end
        ----rbac.go router authority filtering

    -----lib  public Library
    -----file upload file keep in here
    -----models ORM module
        ----admin RBAC database operation
            ----AdminInit.go admin data fill by this
        ----blog  blog database operation

    ----routers url router
    ----static  static file such as css/js
        ---admin  back-end js/css
        ---home  front-end js/css
            ---amazi  Meizi UI(China)
            ---boostrap Most Niubi UI
         ---tool some tool js
         ---diy our diy js/css
    ----views	 template views
        ----admin 	back-end
            ----default defaule theme
        ----home 	front-end
            ----default default theme

    ----front can use for vue/angular... preparing
        ---data JSON data

    ---help  help yu init db
        --- init.sql important data
        --- ngnix-tuzi.conf Nginx config

We have already implement basic RBAC module and Blog module(Article and Album equal to enterprise News and Production), And have a Dashboard back-end UI, The UI can accelerated development.

  1. Role-Based Access Control
  2. Amaze UI v2.7.0(little back-end)和jQuery EasyUI v1.4.2(back-end table CRUD)、Bootstrap v3.3.5(front-end)mixed
  3. Prepare use Vue.js v2.2.6 to separate back-end and front-end(Maybe), back-end just offer REST JSON API, and front-end can first test Off-line then if no problem, docking! when ajax call JSON must pay attention across-domain rule(see rht dir front), why use this way due to can reduce the back-end burden~~ and more fast develop...

b. Rules And Explanation

  1. RBAC function must put in controllers/admin folder.Front-end controllers put in controllers/home folder, other put in controllers/admin.URL router use M/C/A ways, such router rbac/public/index(three)must authorize.
  2. Login:you can logout after login, support cookie remember login. when enter back-end, check session, if not exist session then check cookie. if user is activated, add the session, record login times、login IP etcd. When remember login, will add cookie(cooke bind by ip and encrypted password for hijacking prevention).
  3. System time default timezone UTC/GMT+08:00 China BeiJin, you can change in app.conf.
  4. Back-end template in views/admin, front-end in views/home, the sub folder is theme, which default is default... can change in app.conf.
  5. All config in conf/app.conf, support internationalization, can use chinese/english by browser such Accept-Language:en-US,en;q=0.5
  6. All data initialization can define in models/*/*Init.go, I will change it all in english.
  7. All js/css such static file must put in static
  8. Website home can be change by this(just ignore it...waiting for explanation)

c. Add routers and permissions

Every add routers and permissions in models/admin/AdminInit.go, please rebuild rbac:

./rabbit -rbac=1

debug you can use bee run...

3. How to use Nginx(optional)

First install Nginx(ask for google...), Ubuntu do this: sudo apt-get install nginx

Enter /etc/nginx/conf.d, put our doc/sh/ngnix-tuzi.conf under it, which config ngnix-tuzi.conf, server_name is your domain, access_log is the log path(you must make dir first)

        listen 80;
        charset utf-8;
        access_log /data/logs/nginx/;
        #error_log /data/logs/nginx/;
        location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $http_host;
        proxy_redirect off;
        proxy_pass http://localhost:8080;
	    proxy_set_header X-Real-Ip $remote_addr;



nginx -t
nginx -s reload


Just for debug home!

go run main.go  -config=conf/tuzi.conf -home=home/first

Have a Look!


Copyright 2017 by rabbit author:
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License

Welcome Add PR/issues.

For questions, please email: