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

快速开始

安装
第一个知识库

AI 与 Agent

智能助手(AI)
Agent 开发闭环
CLI Token

核心概念

所见皆文件
工作空间
文档级邀请
无账户身份识别

使用指南

设置页面概览
Markdown 编辑
HTML 文档
流程图生成
知识图谱
草稿与同步
我的文章与邀请
文档收藏
文档评论
受限工作空间成员与模板
恢复码(兼容)

部署与配置

环境要求
配置文件
反向代理示例
客户端壳(Android / 桌面)
FAQ
更新日志
Previous Page配置文件
Next Page客户端壳(Android / 桌面)
mdocs

Write freely. Never lose a word.

MIT License
产品
功能特性Agent 开发闭环竞品对比更新日志
资源
文档安装指南
社区
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";
    }
}

同机 Nginx 反代时,proxy_pass http://127.0.0.1:4000 即可(mdocs 默认监听 0.0.0.0:4000)。若曾手动设过 MDOCS_HOST=127.0.0.1,需改回 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