Meilisearch 完整教學 2026：中文站內搜尋、Docker 部署與實測

services:
  meilisearch:
    image: getmeili/meilisearch:v1.56.1   # 鎖版本，別用 latest
    container_name: meilisearch
    restart: unless-stopped
    ports:
      - "7700:7700"
    environment:
      MEILI_ENV: production
      MEILI_MASTER_KEY: 換成你自己的32字元以上隨機字串
      MEILI_NO_ANALYTICS: "true"
    volumes:
      - ./meili_data:/meili_data
    healthcheck:
      test: ["CMD", "curl", "-fsS", "http://localhost:7700/health"]
      interval: 10s
      timeout: 3s
      retries: 5
      start_period: 10s

curl -s http://127.0.0.1:7700/health
# {"status":"available"}

curl -s -H "Authorization: Bearer $MEILI_MASTER_KEY" http://127.0.0.1:7700/version
# {"commitSha":"421053d...","commitDate":"unknown","pkgVersion":"1.56.1"}

curl -X PATCH http://127.0.0.1:7700/indexes/articles/settings \
  -H "Authorization: Bearer $MEILI_MASTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "searchableAttributes": ["title", "description", "body"],
    "filterableAttributes": ["section", "date"],
    "sortableAttributes": ["date"],
    "rankingRules": ["words", "typo", "proximity", "attribute", "sort", "exactness"]
  }'

curl -X POST http://127.0.0.1:7700/indexes/articles/search \
  -H "Authorization: Bearer $MEILI_SEARCH_KEY" -H "Content-Type: application/json" \
  -d '{"q":"","filter":"section = '\''blog'\'' AND date > '\''2026-10-01'\''","sort":["date:desc"],"facets":["section"]}'

import glob, json, os, re, urllib.request

HOST, KEY = "http://127.0.0.1:7700", os.environ["MEILI_MASTER_KEY"]

def strip_md(t):
    t = re.sub(r"```.*?```", " ", t, flags=re.S)        # 程式碼區塊
    t = re.sub(r"!\[[^\]]*\]\([^)]*\)", " ", t)          # 圖片
    t = re.sub(r"\[([^\]]*)\]\([^)]*\)", r"\1", t)       # 連結留文字
    t = re.sub(r"[#>*`|_\-]{1,}", " ", t)                # 標題/表格/強調符號
    return re.sub(r"\s+", " ", t).strip()

docs = []
for i, f in enumerate(sorted(glob.glob("content/posts/*/*.md"))):
    raw = open(f, encoding="utf-8").read()
    m = re.match(r"^---\n(.*?)\n---\n?(.*)$", raw, re.S)
    if not m:
        continue
    fm, body = m.group(1), m.group(2)
    get = lambda n: (re.search(rf'^{n}:\s*"?([^"\n]+)"?\s*$', fm, re.M) or [None, ""])[1]
    sec = f.split("/")[-2]
    docs.append({
        "id": i + 1,
        "title": get("title"),
        "description": get("description"),
        "body": strip_md(body)[:1500],
        "section": sec,
        "date": get("date"),
        "url": f"/posts/{sec.lower()}/{get('slug') or os.path.basename(f)[:-3]}/",
    })

req = urllib.request.Request(
    f"{HOST}/indexes/articles/documents",
    data=json.dumps(docs).encode(), method="POST",
    headers={"Content-Type": "application/json", "Authorization": f"Bearer {KEY}"},
)
print(json.loads(urllib.request.urlopen(req, timeout=120).read())["taskUid"])

{"q":"反向代理","attributesToHighlight":["title","body"],
 "attributesToCrop":["body"],"cropLength":40}

{"synonyms": {"备份": ["備份"], "机器学习": ["機器學習"], "反代": ["反向代理"]}}

<input id="q" type="search" placeholder="搜尋文章…" autocomplete="off">
<p id="status"></p>
<ul id="hits"></ul>

<script>
const HOST = "https://search.example.com";   // 你的 Meilisearch
const KEY  = "只放 search-only key";
const INDEX = "articles";

const qEl = document.getElementById("q");
const statusEl = document.getElementById("status");
const hitsEl = document.getElementById("hits");

async function search(q) {
  if (!q.trim()) { hitsEl.innerHTML = ""; statusEl.textContent = ""; return; }
  const res = await fetch(`${HOST}/indexes/${INDEX}/search`, {
    method: "POST",
    headers: { "Content-Type": "application/json", "Authorization": `Bearer ${KEY}` },
    body: JSON.stringify({
      q, limit: 5,
      attributesToHighlight: ["title", "description"],
      attributesToCrop: ["description"], cropLength: 60
    })
  });
  const data = await res.json();
  statusEl.textContent = `${data.estimatedTotalHits} 筆結果（${data.processingTimeMs} ms）`;
  hitsEl.innerHTML = data.hits.map(h => `
    <li><a href="${h.url}">${h._formatted.title}</a>
    <div class="meta">${h._formatted.description || ""}</div></li>`).join("");
}

let timer;
qEl.addEventListener("input", () => {
  clearTimeout(timer);
  timer = setTimeout(() => search(qEl.value), 120);   // debounce
});
</script>