Merge remote-tracking branch 'upstream/master'

Dockerfile

@@ -1,95 +1,135 @@
-FROM golang:1.11.4-alpine3.8 AS build
+FROM amd64/golang:1.13 AS build
 
-#新增 GLIBC
-ENV GLIBC_VERSION "2.28-r0"
+ARG TAG=0.0.1
 
-# Download and install glibc
-RUN apk add --update && \
-    apk add --no-cache --upgrade \
-    ca-certificates \
-    gcc \
-    g++ \
-    make \
-    curl \
-    git
-
-RUN curl -Lo /etc/apk/keys/sgerrand.rsa.pub "https://alpine-pkgs.sgerrand.com/sgerrand.rsa.pub" && \
-    curl -Lo /var/glibc.apk "https://github.com/sgerrand/alpine-pkg-glibc/releases/download/${GLIBC_VERSION}/glibc-${GLIBC_VERSION}.apk" && \
-    curl -Lo /var/glibc-bin.apk "https://github.com/sgerrand/alpine-pkg-glibc/releases/download/${GLIBC_VERSION}/glibc-bin-${GLIBC_VERSION}.apk" && \
-    apk add /var/glibc-bin.apk /var/glibc.apk && \
-    /usr/glibc-compat/sbin/ldconfig /lib /usr/glibc-compat/lib && \
-    echo 'hosts: files mdns4_minimal [NOTFOUND=return] dns mdns4' >> /etc/nsswitch.conf
-
-#掛載 calibre 最新3.x
-
-ENV LD_LIBRARY_PATH $LD_LIBRARY_PATH:/opt/calibre/lib
-ENV PATH $PATH:/opt/calibre/bin
-
-RUN curl -Lo /var/linux-installer.py https://download.calibre-ebook.com/linux-installer.py
-
-#RUN mkdir -p /go/src/github.com/lifei6671/ && cd /go/src/github.com/lifei6671/ && git clone https://github.com/mindoc-org/mindoc.git && cd mindoc
+# 编译-环境变量
+ENV GO111MODULE=on
+ENV GOPROXY=https://goproxy.cn,direct
+ENV CGO_ENABLED=1
+ENV GOARCH=amd64
+ENV GOOS=linux
 
+# 工作目录
 ADD . /go/src/github.com/mindoc-org/mindoc
-
 WORKDIR /go/src/github.com/mindoc-org/mindoc
 
-RUN	 go get -u github.com/golang/dep/cmd/dep && dep ensure  && \
-    CGO_ENABLE=1 go build -v -a -o mindoc_linux_amd64 -ldflags="-w -s -X main.VERSION=$TAG -X 'main.BUILD_TIME=`date`' -X 'main.GO_VERSION=`go version`'" && \
-    rm -rf commands controllers models modules routers tasks vendor docs search data utils graphics .git Godeps uploads/* .gitignore .travis.yml Dockerfile gide.yaml LICENSE main.go README.md conf/enumerate.go conf/mail.go install.lock simsun.ttc
-
-ADD start.sh /go/src/github.com/mindoc-org/mindoc
-ADD simsun.ttc /usr/share/fonts/win/
+# 编译
+RUN go env
+RUN go mod tidy -v
+RUN go build -o mindoc_linux_amd64 -ldflags "-w -s -X 'main.VERSION=$TAG' -X 'main.BUILD_TIME=`date`' -X 'main.GO_VERSION=`go version`'"
+RUN cp conf/app.conf.example conf/app.conf
+# 清理不需要的文件
+RUN rm appveyor.yml docker-compose.yml Dockerfile .travis.yml .gitattributes .gitignore go.mod go.sum main.go README.md simsun.ttc start.sh conf/*.go
+RUN rm -rf cache commands controllers converter .git .github graphics mail models routers utils
 
-FROM alpine:latest
-
-LABEL maintainer="[email protected]"
-
-RUN apk add --update && \
-    apk add --no-cache --upgrade \
-    tzdata \
-    mesa-gl \
-    python \
-    qt5-qtbase-x11 \
-    xdg-utils \
-    libxrender \
-    libxcomposite \
-    xz \
-    imagemagick \
-    imagemagick-dev \
-    msttcorefonts-installer \
-    fontconfig && \
-    update-ms-fonts && \
-    fc-cache -f
-
-COPY --from=build /var/glibc.apk .
-COPY --from=build /var/glibc-bin.apk .
-COPY --from=build /etc/apk/keys/sgerrand.rsa.pub /etc/apk/keys/sgerrand.rsa.pub
-COPY --from=build /var/linux-installer.py .
-COPY --from=build /usr/share/fonts/win/simsun.ttc /usr/share/fonts/win/
-COPY --from=build /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/ca-certificates.crt
-COPY --from=build /go/src/github.com/mindoc-org/mindoc /mindoc
+# 测试编译的mindoc是否ok
+RUN ./mindoc_linux_amd64 version
 
-RUN  apk add glibc-bin.apk glibc.apk && \
-    /usr/glibc-compat/sbin/ldconfig /lib /usr/glibc-compat/lib && \
-    echo 'hosts: files mdns4_minimal [NOTFOUND=return] dns mdns4' >> /etc/nsswitch.conf && \
-    rm -rf glibc.apk glibc-bin.apk /var/cache/apk/* && \
-    chmod a+r /usr/share/fonts/win/simsun.ttc
+# 必要的文件复制
+ADD simsun.ttc /usr/share/fonts/win/
+ADD start.sh /go/src/github.com/mindoc-org/mindoc
 
 
-ENV LD_LIBRARY_PATH $LD_LIBRARY_PATH:/opt/calibre/lib
-ENV PATH $PATH:/opt/calibre/bin
+# Ubuntu 20.04
+FROM ubuntu:focal
 
-RUN cat linux-installer.py | python -c "import sys; main=lambda x,y:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main(install_dir='/opt', isolated=True)" && \
-    rm -rf /tmp/* linux-installer.py
+# 切换默认shell为bash
+SHELL ["/bin/bash", "-c"]
 
+COPY --from=build /usr/share/fonts/win/simsun.ttc /usr/share/fonts/win/
+COPY --from=build /go/src/github.com/mindoc-org/mindoc /mindoc
 WORKDIR /mindoc
-
-
-# 时区设置
+RUN chmod a+r /usr/share/fonts/win/simsun.ttc
+
+# 备份原有源
+RUN mv /etc/apt/sources.list /etc/apt/sources.list-backup
+# 最小化源，缩短apt update时间(ca-certificates必须先安装才支持换tsinghua源)
+RUN echo 'deb http://archive.ubuntu.com/ubuntu/ focal main restricted' > /etc/apt/sources.list
+RUN apt-get update
+RUN apt install -y ca-certificates
+# 更换aliyun源(echo多行内容不能以#开头，会被docker误判为注释行，所以采用\n#开头)
+RUN echo $'\
+deb http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse\
+\n# deb-src http://mirrors.aliyun.com/ubuntu/ focal main restricted universe multiverse\n\
+deb http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse\
+\n# deb-src http://mirrors.aliyun.com/ubuntu/ focal-security main restricted universe multiverse\n\
+deb http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse\
+\n# deb-src http://mirrors.aliyun.com/ubuntu/ focal-updates main restricted universe multiverse\n\
+deb http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse\
+\n# deb-src http://mirrors.aliyun.com/ubuntu/ focal-proposed main restricted universe multiverse\n\
+deb http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse\
+\n# deb-src http://mirrors.aliyun.com/ubuntu/ focal-backports main restricted universe multiverse'\
+> /etc/apt/sources.list
+
+# 更新软件包信息
+RUN apt-get update
+# 安装必要的系统工具
+RUN apt install -y apt-transport-https ca-certificates curl wget xz-utils
+
+# 时区设置(如果不设置, calibre依赖的tzdata在安装过程中会要求选择时区)
 ENV TZ=Asia/Shanghai
 RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
+# tzdata的前端类型默认为readline（Shell情况下）或dialog（支持GUI的情况下）
+ARG DEBIAN_FRONTEND=noninteractive
+# 安装时区信息
+RUN apt install -y --no-install-recommends tzdata
+# 重新配置tzdata软件包，使得时区设置生效
+RUN dpkg-reconfigure --frontend noninteractive tzdata
+
+# 安装 calibre 依赖的包
+RUN apt install -y libgl-dev libnss3-dev libxcomposite-dev libxrandr-dev libxi-dev
+# 安装文泉驿字体
+RUN apt install -y fonts-wqy-microhei fonts-wqy-zenhei
+# 安装中文语言包
+RUN apt-get install -y locales language-pack-zh-hans language-pack-zh-hans-base
+# 设置默认编码
+RUN locale-gen "zh_CN.UTF-8"
+RUN update-locale LANG=zh_CN.UTF-8
+ENV LANG=zh_CN.UTF-8
+ENV LANGUAGE=zh_CN:en
+ENV LC_ALL=zh_CN.UTF-8
+# 安装-calibre
+# RUN apt-get install -y calibre # 此种方式安装省事，但会安装很多额外不需要的软件包，导致体积过大
+RUN mkdir -p /tmp/calibre-cache
+# 获取最新版本号
+RUN curl -s http://code.calibre-ebook.com/latest>/tmp/calibre-cache/version
+# 下载最新版本
+# RUN wget -O /tmp/calibre-cache/calibre-x86_64.txz -c https://download.calibre-ebook.com/`cat /tmp/calibre-cache/version`/calibre-`cat /tmp/calibre-cache/version`-x86_64.txz
+# 使用 download.fastgit.org 替换 github 实现加速
+RUN wget -O /tmp/calibre-cache/calibre-x86_64.txz -c https://download.fastgit.org/kovidgoyal/calibre/releases/download/v`cat /tmp/calibre-cache/version`/calibre-`cat /tmp/calibre-cache/version`-x86_64.txz
+# 注: 调试阶段，下载alibre-5.22.1-x86_64.txz到本地(使用 python -m http.server)，加速构建
+# RUN wget -O /tmp/calibre-cache/calibre-x86_64.txz -c http://10.96.8.252:8000/calibre-5.22.1-x86_64.txz
+# 解压
+RUN mkdir -p /opt/calibre
+# RUN tar --extract --file=/tmp/calibre-cache/calibre-x86_64.txz --directory /opt/calibre
+RUN tar xJof /tmp/calibre-cache/calibre-x86_64.txz -C /opt/calibre
+ENV PATH=$PATH:/opt/calibre
+# 设置calibre相关环境变量
+ENV QTWEBENGINE_CHROMIUM_FLAGS="--no-sandbox"
+ENV QT_QPA_PLATFORM='offscreen'
+# 测试 calibre 可正常使用
+RUN ebook-convert --version
+# 清理calibre缓存
+RUN rm -rf /tmp/calibre-cache
+
+# refer: https://docs.docker.com/engine/reference/builder/#volume
+# 数据同步目录
+VOLUME /mindoc-sync-host
+
+# refer: https://docs.docker.com/engine/reference/builder/#expose
+EXPOSE 8181/tcp
+
+# 如果配置文件不存在就复制
+RUN cp --no-clobber /mindoc/conf/app.conf.example /mindoc/conf/app.conf
 
 ENV ZONEINFO=/mindoc/lib/time/zoneinfo.zip
-RUN chmod +x start.sh
+RUN chmod +x /mindoc/start.sh
+
+ENTRYPOINT ["/bin/bash", "/mindoc/start.sh"]
 
-CMD ["./start.sh"]
+# https://docs.docker.com/engine/reference/commandline/build/#options
+# docker build --progress plain --rm --build-arg TAG=2.0.1 --tag gsw945/mindoc:2.0.1 .
+# https://docs.docker.com/engine/reference/commandline/run/#options
+# set MINDOC=//d/mindoc # windows
+# export MINDOC=/home/ubuntu/mindoc-docker # linux
+# docker run --rm -it  -p 8181:8181 -v "%MINDOC%":"/mindoc-sync-host" --name mindoc -e MINDOC_ENABLE_EXPORT=true -d gsw945/mindoc:2.0.1

README.md

@@ -11,7 +11,9 @@ MinDoc 的前身是 [SmartWiki](https://github.com/lifei6671/SmartWiki) 文档
 
 可以用来储存日常接口文档，数据库字典，手册说明等文档。内置项目管理，用户管理，权限管理等功能，能够满足大部分中小团队的文档管理需求。
 
-演示站点： [https://www.iminho.me/wiki/](https://www.iminho.me/wiki/)
+##### 演示站点&文档:
+- https://www.iminho.me/wiki/docs/mindoc/
+- https://doc.gsw945.com/docs/mindoc-docs/
 
 ---
 
@@ -24,6 +26,11 @@ MinDoc 的前身是 [SmartWiki](https://github.com/lifei6671/SmartWiki) 文档
 遇到问题请提 [Issues](https://github.com/mindoc-org/mindoc/issues )，欢迎使用者和贡献者加入QQ群 `1051164153`
 <a target="_blank" href="https://qm.qq.com/cgi-bin/qm/qr?k=bHFR7P3Qp1nsSPbsTw4KN_ZpFLUAblIU&jump_from=webapi"><img border="0" src="https://pub.idqqimg.com/wpa/images/group.png" alt="MinDoc使用&amp;开发交流群" title="MinDoc使用&amp;开发交流群"></a>
 
+对开发感兴趣请关注 [Development](https://github.com/mindoc-org/mindoc/projects/1):
+- [Todo List](https://github.com/mindoc-org/mindoc/projects/1#column-13554511)
+- [Work in progress](https://github.com/mindoc-org/mindoc/projects/1#column-13554512)
+- [Review in progress](https://github.com/mindoc-org/mindoc/projects/1#column-13554513)
+
 ---
 
 # 安装与使用
@@ -35,7 +42,9 @@ MinDoc 的前身是 [SmartWiki](https://github.com/lifei6671/SmartWiki) 文档
 对于没有Golang使用经验的用户，可以从 [https://github.com/mindoc-org/mindoc/releases](https://github.com/mindoc-org/mindoc/releases) 这里下载编译完的程序。
 
 如果有Golang开发经验，建议通过编译安装，要求golang版本不小于1.13(需支持`CGO`和`go mod`)。
+> 注意: CentOS7上GLibC版本低，需要源码编译, 编译好的二进制文件无法运行。
 
+## 常规编译
 ```bash
 # 克隆源码
 git clone https://github.com/mindoc-org/mindoc.git
@@ -47,7 +56,6 @@ go build -ldflags "-w"
 ./mindoc install
 # 执行
 ./mindoc
-
 ```
 
 MinDoc 如果使用MySQL储存数据，则编码必须是`utf8mb4_general_ci`。请在安装前，把数据库配置填充到项目目录下的 `conf/app.conf` 中。
@@ -58,6 +66,31 @@ MinDoc 如果使用MySQL储存数据，则编码必须是`utf8mb4_general_ci`。
 
 **默认程序会自动初始化一个超级管理员用户：admin 密码：123456 。请登录后重新设置密码。**
 
+## Linux系统中不依赖gLibC的编译方式
+
+### 安装 musl-gcc
+```bash
+wget -c http://www.musl-libc.org/releases/musl-1.2.2.tar.gz
+tar -xvf musl-1.2.2.tar.gz
+cd musl-1.2.2
+./configure
+make
+sudo make install
+```
+### 使用 musl-gcc 编译 mindoc
+```bash
+go mod tidy -v
+export GOARCH=amd64
+export GOOS=linux
+# 设置使用musl-gcc
+export CC=/usr/local/musl/bin/musl-gcc
+# 设置版本
+export TRAVIS_TAG=temp-musl-v`date +%y%m%d`
+go build -o mindoc_linux_musl_amd64 --ldflags="-linkmode external -extldflags '-static' -w -X 'github.com/mindoc-org/mindoc/conf.VERSION=$TRAVIS_TAG' -X 'github.com/mindoc-org/mindoc/conf.BUILD_TIME=`date`' -X 'github.com/mindoc-org/mindoc/conf.GO_VERSION=`go version`'"
+# 验证
+./mindoc_linux_amd64 version
+```
+
 
 ```bash
 
@@ -80,26 +113,42 @@ mail_expired=30
 
 
 # 使用Docker部署
-如果是Docker用户，可参考项目内置的Dockerfile文件编译镜像。
-
-在启动镜像时需要提供如下的环境变量：
+如果是Docker用户，可参考项目内置的Dockerfile文件自行编译镜像(编译命令见Dockerfile文件底部注释，仅供参考)。
 
+在启动镜像时需要提供如下的常用环境变量(全部支持的环境变量请参考: [`conf/app.conf.example`](https://github.com/mindoc-org/mindoc/blob/master/conf/app.conf.example))：
 ```ini
-DB_ADAPTER                  指定 DB
+DB_ADAPTER                  指定DB类型(默认为sqlite)
 MYSQL_PORT_3306_TCP_ADDR    MySQL地址
 MYSQL_PORT_3306_TCP_PORT    MySQL端口号
 MYSQL_INSTANCE_NAME         MySQL数据库名称
 MYSQL_USERNAME              MySQL账号
 MYSQL_PASSWORD              MySQL密码
 HTTP_PORT                   程序监听的端口号
+MINDOC_ENABLE_EXPORT        开启导出(默认为false)
 ```
 
-举个栗子
+### 举个栗子-当前(公开)镜像(信息页面: https://cr.console.aliyun.com/images/cn-hangzhou/mindoc-org/mindoc/detail , 需要登录阿里云账号才可访问列表)
+##### Windows
+```bash
+set MINDOC=//d/mindoc
+docker run -it --name=mindoc --restart=always -v "%MINDOC%":"/mindoc-sync-host" -p 8181:8181 -e MINDOC_ENABLE_EXPORT=true -d registry.cn-hangzhou.aliyuncs.com/mindoc-org/mindoc:v2.1-beta.5
+```
+
+##### Linux、Mac
+```bash
+export MINDOC=/home/ubuntu/mindoc-docker
+docker run -it --name=mindoc --restart=always -v "${MINDOC}":"/mindoc-sync-host" -p 8181:8181 -e MINDOC_ENABLE_EXPORT=true -d registry.cn-hangzhou.aliyuncs.com/mindoc-org/mindoc:v2.1-beta.5
+```
 
+##### 举个栗子-更多环境变量示例(镜像已过期，仅供参考，请以当前镜像为准)
 ```bash
-# TODO: 新版docker镜像将使用阿里云，配置中
 docker run -p 8181:8181 --name mindoc -e DB_ADAPTER=mysql -e MYSQL_PORT_3306_TCP_ADDR=10.xxx.xxx.xxx -e MYSQL_PORT_3306_TCP_PORT=3306 -e MYSQL_INSTANCE_NAME=mindoc -e MYSQL_USERNAME=root -e MYSQL_PASSWORD=123456 -e httpport=8181 -d daocloud.io/lifei6671/mindoc:latest
 ```
+
+#### dockerfile内容参考
+- [无需代理直接加速各种 GitHub 资源拉取 | 国内镜像赋能 | 助力开发](https://blog.frytea.com/archives/504/)
+- [阿里云 - Ubuntu 镜像](https://developer.aliyun.com/mirror/ubuntu)
+
 ### docker-compose 一键安装
 
 1. 修改配置文件
@@ -176,7 +225,7 @@ docker run -p 8181:8181 --name mindoc -e DB_ADAPTER=mysql -e MYSQL_PORT_3306_TCP
 - MySQL 5.6
 - [editor.md](https://github.com/pandao/editor.md) Markdown 编辑器
 - [Bootstrap](https://github.com/twbs/bootstrap) 3.2
-- jQuery(https://github.com/jquery/jquery) 库
+- [jQuery](https://github.com/jquery/jquery) 库
 - [WebUploader](https://github.com/fex-team/webuploader) 文件上传框架
 - [NProgress](https://github.com/rstacruz/nprogress) 库
 - [jsTree](https://github.com/vakata/jstree) 树状结构库
@@ -187,6 +236,10 @@ docker run -p 8181:8181 --name mindoc -e DB_ADAPTER=mysql -e MYSQL_PORT_3306_TCP
 - ~~to-markdown~~[Turndown](https://github.com/domchristie/turndown) HTML转Markdown库
 - ~~quill 富文本编辑器~~
 - [wangEditor](https://github.com/wangeditor-team/wangEditor) 富文本编辑器
+  - 参考
+    - [wangEditor v4.7 富文本编辑器教程](https://www.bookstack.cn/books/wangeditor-4.7-zh)
+    - [扩展菜单注册太过繁琐 #2493](https://github.com/wangeditor-team/wangEditor/issues/2493)
+  - 工具： `https://babeljs.io/repl` + `@babel/plugin-transform-classes`
 - [Vue.js](https://github.com/vuejs/vue) 框架
 
 
@@ -210,6 +263,3 @@ docker run -p 8181:8181 --name mindoc -e DB_ADAPTER=mysql -e MYSQL_PORT_3306_TCP
 
 一个不纯粹的PHPer，一个不自由的 gopher 。
 
-# 支持 MinDoc
-
-![支付宝](https://raw.githubusercontent.com/lifei6671/mindoc/master/static/images/alipay.png) ![微信支付](https://raw.githubusercontent.com/lifei6671/mindoc/master/static/images/weixin.png)

cache/cache.go

@@ -7,8 +7,8 @@ import (
 	"errors"
 	"time"
 
-	"github.com/beego/beego/v2/core/logs"
 	"github.com/beego/beego/v2/client/cache"
+	"github.com/beego/beego/v2/core/logs"
 )
 
 var bm cache.Cache