~/tools / Chạy LLM cục bộ trên máy chủ của bạn / Ollama systemd Override Generator

Ollama systemd Override Generator — Tạo override systemd cho Ollama: OLLAMA_HOST, OLLAMA_MODELS, KEEP_ALIVE và hơn thế nữa

Tạo tệp override của systemd để đặt các biến môi trường của Ollama trên máy chủ Linux: địa chỉ lắng nghe, thư mục mô hình, thời gian mô hình ở lại trong bộ nhớ, độ dài ngữ cảnh, các yêu cầu song song, Flash Attention, loại bộ nhớ đệm K/V, các nguồn gốc (origin) bổ sung, chế độ chỉ chạy cục bộ và proxy HTTPS. Mọi biến đều lấy từ FAQ chính thức của Ollama, và mỗi giá trị được đặt trong dấu ngoặc kép theo đúng cách systemd đọc. Dữ liệu không rời khỏi trình duyệt của bạn.

Biến môi trường

Các ô trống sẽ không được ghi ra. Chữ màu xám là giá trị mặc định nêu trong FAQ của Ollama.

Tệp override cho systemctl edit

Dán đoạn này vào trình soạn thảo mà sudo systemctl edit ollama.service mở ra, giữa hai dòng chú thích. Nó được lưu thành /etc/systemd/system/ollama.service.d/override.conf.

[Service]
Environment="OLLAMA_KEEP_ALIVE=10m"
Environment="OLLAMA_CONTEXT_LENGTH=8192"
Environment="OLLAMA_MAX_LOADED_MODELS=1"
Environment="OLLAMA_NO_CLOUD=1"

Lệnh

Chạy chúng trên máy chủ theo thứ tự này. Lệnh cuối cùng hiển thị các biến mà dịch vụ đã nhận. Khi bạn đổi OLLAMA_MODELS, hai lệnh đầu tạo thư mục và giao nó cho người dùng ollama; mkdir -p là phần chúng tôi thêm, vì chown báo lỗi với một thư mục chưa tồn tại.

sudo systemctl edit ollama.service
sudo systemctl daemon-reload
sudo systemctl restart ollama
systemctl show ollama --property=Environment

Các biến và giá trị mặc định theo FAQ của Ollama, và quy tắc đặt ngoặc kép theo hướng dẫn systemd.exec, kiểm tra vào ngày 2026-11-03. Ollama FAQ / systemd.exec: Environment=

Mọi thứ được xử lý trong trình duyệt của bạn. Không có gì bạn nhập được gửi đi đâu cả.

Khi Ollama chạy như một dịch vụ systemd trên Linux, FAQ chính thức hướng dẫn đặt các biến môi trường của nó bằng systemctl edit ollama.service: thêm mỗi biến một dòng Environment dưới [Service], lưu lại, rồi chạy systemctl daemon-reload và systemctl restart ollama. Các bước rất ngắn, nhưng các chi tiết dễ làm sai. systemd mở rộng các specifier, nên dấu % phải được viết thành %%; dấu gạch chéo ngược hoặc dấu ngoặc kép bên trong một phép gán có đặt trong ngoặc kép sẽ bị đọc như ký tự thoát; và một giá trị có dấu cách phải được đặt trong ngoặc kép toàn bộ. Công cụ này viết sẵn tệp override cho bạn. Nó chỉ đưa ra các biến được ghi trong FAQ, hiển thị giá trị mặc định đã được ghi bên cạnh mỗi biến, đặt mọi phép gán trong ngoặc kép dưới dạng "NAME=value" và viết đôi dấu %. Nó cảnh báo khi một giá trị khiến Ollama lắng nghe trên mọi giao diện mạng, khi một số lượng không phải số nguyên, và khi bộ nhớ đệm K/V lượng tử hóa được chọn trong lúc Flash Attention bị tắt. Chúng tôi đã kiểm tra kết quả trên Ubuntu 24.04 với systemd 255: chúng tôi dán nó vào systemctl edit và xác nhận rằng dịch vụ nhận từng giá trị nguyên vẹn, kể cả dấu cách, $, ' và %.

Phần xử lý chính của công cụ này là mã nguồn mở theo giấy phép MIT. github.com/seigo5555/toolkitbox-lib/src/ollama-systemd.ts

Trường hợp dùng

  • Giữ mô hình trong bộ nhớ lâu hơn, hoặc gỡ ra sớm hơn, trên một VPS nhỏ bằng OLLAMA_KEEP_ALIVE
  • Chuyển các tệp mô hình sang một ổ đĩa lớn hơn bằng OLLAMA_MODELS
  • Giới hạn Ollama chỉ tải một mô hình và đặt độ dài ngữ cảnh mặc định cho máy chủ có ít bộ nhớ

Cách dùng

  1. Chỉ điền những biến bạn muốn thay đổi. Các ô trống sẽ không được ghi ra, nên Ollama giữ nguyên giá trị mặc định. Chữ màu xám trong mỗi ô là giá trị mặc định mà FAQ nêu.
  2. Hãy đọc các cảnh báo. Một địa chỉ lắng nghe khác 127.0.0.1 hoặc localhost khiến các máy khác có thể truy cập Ollama, và FAQ không mô tả cơ chế xác thực nào cho trường hợp đó.
  3. Chạy sudo systemctl edit ollama.service, dán đoạn văn bản vào trình soạn thảo giữa hai dòng chú thích, lưu rồi thoát. Sau đó chạy các lệnh còn lại để nạp lại systemd, khởi động lại Ollama và kiểm tra các giá trị nó đã nhận.

Hỏi đáp

Tệp được lưu ở đâu?

systemctl edit lưu nó thành một tệp drop-in, /etc/systemd/system/ollama.service.d/override.conf, và không thay đổi tệp unit chính. Khi chúng tôi chạy nó trên Ubuntu 24.04, trình soạn thảo hiển thị dòng chú thích ### Anything between here and the comment below will become the contents of the drop-in file. Hãy dán đoạn văn bản vào giữa dòng chú thích đó và dòng chú thích bên dưới nó.

Tại sao mọi giá trị đều được đặt trong ngoặc kép?

Tài liệu systemd nói rằng một giá trị chứa dấu cách hoặc dấu bằng phải có ngoặc kép bao quanh toàn bộ phép gán. Đặt mọi dòng trong ngoặc kép theo cùng một cách giúp các đường dẫn có dấu cách và các danh sách như OLLAMA_ORIGINS được giữ nguyên vẹn. Tài liệu cũng nói rằng $ ở đây không có ý nghĩa đặc biệt nên được chuyển nguyên văn, trong khi % bắt đầu một specifier, vì vậy công cụ viết %% khi cần một dấu % đúng nghĩa.

Những ký tự nào không được chấp nhận?

Dấu ngoặc kép, dấu gạch chéo ngược và các ký tự điều khiển như tab. Bên trong một phép gán có đặt trong ngoặc kép, systemd đọc chúng như ký tự thoát hoặc từ chối chúng, nên giá trị sẽ không đến được Ollama đúng như đã nhập. Công cụ báo chúng là lỗi và bỏ dòng đó ra.

Đặt OLLAMA_HOST thành 0.0.0.0 có an toàn không?

Nó khiến Ollama lắng nghe trên mọi giao diện mạng, nên các máy khác có thể truy cập nó. FAQ nói rằng Ollama mặc định gắn với 127.0.0.1 cổng 11434 và không mô tả cơ chế xác thực nào cho máy chủ. Khuyến nghị của chúng tôi, không phải lời của tài liệu: giữ nguyên giá trị mặc định và truy cập Ollama qua một đường hầm SSH hoặc một proxy có mật khẩu và HTTPS, đồng thời giới hạn cổng 11434 trong tường lửa.

Tôi có thể đặt mật khẩu trong HTTPS_PROXY không?

Công cụ cảnh báo khi địa chỉ proxy chứa tên người dùng và mật khẩu. Tài liệu systemd nói rằng biến môi trường không phù hợp để truyền bí mật, vì các giá trị được đặt cho một unit có thể bị các client không có đặc quyền đọc. FAQ cũng nói nên tránh đặt HTTP_PROXY, vì Ollama chỉ tải mô hình qua HTTPS và HTTP_PROXY có thể làm gián đoạn kết nối của client, nên công cụ chỉ cung cấp HTTPS_PROXY.

Có gì được gửi đến máy chủ không?

Không. Tệp override được ghép ngay trong trình duyệt của bạn.

Bài viết liên quan

Liên quan