Vấn đềBạn đã sẵn sàng để thử nghiệm một Mô hình Ngôn ngữ Lớn (LLM) mới, nhưng Ollama lại từ chối. Bạn nhập một lệnh, và thay vì thấy thanh tiến trình tải xuống, bạn nhận được một thông báo lỗi ngắn gọn:
Error: model not found, try pulling it first
Điều này thường xảy ra trong khi thực hiện lệnh ollama run hoặc ollama pull. Ngay cả khi model tồn tại trong thư viện chính thức, chỉ cần một dấu gạch ngang đặt sai chỗ hoặc thiếu tag phiên bản cũng có thể làm hỏng yêu cầu. CLI không báo rằng model không tồn tại; nó báo rằng nó không tìm thấy kết quả khớp cho chuỗi ký tự cụ thể mà bạn đã nhập.
Quy trình kiểm tra lỗi (Debug)Trước khi bạn cài đặt lại mọi thứ, hãy kiểm tra ba nguyên nhân phổ biến sau để thu hẹp phạm vi vấn đề:
1. Xác minh chính xác tên modelOllama rất khắt khe về quy ước đặt tên. Một sai lầm phổ biến là sử dụng tên chung chung không tồn tại trong registry hoặc thêm dấu cách vào chỗ đáng lẽ phải là dấu gạch ngang. Ví dụ, llama 3 sẽ không bao giờ hoạt động, nhưng llama3 thì có.
2. Kiểm tra các tag bị thiếuTheo mặc định, Ollama sẽ tìm kiếm tag :latest. Nếu người tạo model chỉ tải lên các phiên bản cụ thể (như :7b hoặc :v1.5) và bỏ qua manifest 'latest', việc pull sẽ thất bại ngay lập tức.
3. Kiểm tra kết nối tới RegistryĐôi khi mạng nội bộ của bạn chặn registry.ollama.ai. Bạn có thể kiểm tra kết nối bằng cách ping API thông qua terminal bằng lệnh curl.
curl -I https://registry.ollama.ai/v2/
Các giải pháp khắc phục lỗi### Giải pháp 1: Sử dụng tên chính thức trong thư việnĐừng đoán tên model. Hãy truy cập Thư viện Ollama và sao chép chính xác chuỗi ký tự. Ví dụ, người dùng thường cố gắng pull llama-3, nhưng tên chính thức trong registry là llama3.
Sai:
ollama pull llama-3
Đúng:
ollama pull llama3
Giải pháp 2: Chỉ định đúng TagNếu bạn cần một kích thước tham số cụ thể, bạn phải thêm nó vào sau dấu hai chấm. Nếu bạn bỏ qua tag và người duy trì không chỉ định phiên bản 'latest', bạn sẽ thấy lỗi 'not found'. Điều này thường gặp với các model chuyên biệt.
# Nếu lệnh này thất bại:
ollama pull deepseek-coder
# Thử chỉ định kích thước (ví dụ: phiên bản tham số 6.7B):
ollama pull deepseek-coder:6.7b
Giải pháp 3: Cập nhật Ollama ServerCác model mới hơn thường yêu cầu phiên bản mới nhất của engine Ollama để nhận dạng định dạng manifest của chúng. Nếu bạn đang cố gắng pull một model vừa được phát hành trong vài ngày qua, bản build local của bạn có thể đã cũ. Hãy đảm bảo bạn đang chạy ít nhất phiên bản 0.3.0 cho các bản phát hành mới nhất.
Trên Linux:
curl -fsSL https://ollama.com/install.sh | sh
Trên macOS/Windows: Tải xuống trình cài đặt mới nhất từ trang web chính thức và ghi đè lên ứng dụng hiện tại của bạn. Quá trình này mất khoảng 30 giây.
Giải pháp 4: Sửa lỗi Proxy và biến môi trườngTường lửa của doanh nghiệp thường chặn daemon Ollama kết nối tới registry. Ngay cả khi trình duyệt của bạn hoạt động bình thường, dịch vụ chạy ngầm có thể không kết nối được internet. Bạn phải thiết lập rõ ràng biến HTTPS_PROXY cho dịch vụ.
Trên Linux sử dụng systemd:
sudo systemctl edit ollama.service
Thêm các dòng sau vào tệp:
[Service]
Environment="HTTPS_PROXY=http://proxy.example.com:8080"
Sau đó tải lại cấu hình và khởi động lại dịch vụ:
sudo systemctl daemon-reload
sudo systemctl restart ollama
Xác minhĐể xác nhận việc khắc phục thành công, hãy thử pull một model nhỏ như phi3:mini (khoảng 2.3GB). Nếu bạn thấy manifest đang được tải xuống, bạn đã giải quyết được vấn đề:
$ ollama pull llama3
pulling manifest
pulling 6a383e581415... 100%
Sau khi quá trình tải xuống hoàn tất, hãy kiểm tra danh sách local để đảm bảo nó đã sẵn sàng:
ollama list