logo
mdocs
首页
特性
开始
文档
GitHub
首页
特性
开始
文档
GitHub
logo
mdocs

快速开始

安装
第一个知识库

核心概念

所见皆文件
域隔离
文档级邀请
无账户身份识别

使用指南

设置页面概览
Markdown 编辑
流程图生成
草稿与同步
我的文章与邀请
文档收藏
文档评论
受限域成员与模板
CLI Token
恢复码与身份找回

部署与配置

环境要求
配置文件
反向代理示例
FAQ
更新日志
Previous Page配置文件
Next PageFAQ
mdocs

Write freely. Never lose a word.

MIT License
产品
功能特性竞品对比更新日志
资源
文档安装指南
社区
GitHub问题反馈
© 2026 mdocs · Made with ♥ by xuhuafeifei

#反向代理配置

生产部署时,推荐将 mdocs 放在反向代理之后,由代理层处理 TLS 证书、域名绑定、日志等。

#Nginx

server {
    listen 443 ssl;
    server_name docs.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:4000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # WebSocket 支持(如果需要)
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

注意:如果 mdocs 运行在 127.0.0.1,记得将 MDOCS_HOST 设为 0.0.0.0 或去掉限制,否则反向代理无法访问。

#Caddy

docs.yourdomain.com {
    reverse_proxy localhost:4000
}

#Docker Compose

services:
  mdocs:
    build: .
    ports:
      - "127.0.0.1:4000:4000"
    environment:
      - MDOCS_DATA_DIR=/data
    volumes:
      - mdocs-data:/data

  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    depends_on:
      - mdocs