fetchmailconf - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

fetchmail - tìm nạp thư từ máy chủ hỗ trợ POP, IMAP, ETRN hoặc ODMR

SYNOPSIS

nhận thư [Lựa chọn...] [máy chủ thư ...]
nạpmailconf

MÔ TẢ

nhận thư là một tiện ích chuyển tiếp và truy xuất thư; nó tìm nạp thư từ điều khiển từ xa
máy gửi thư và chuyển tiếp nó đến hệ thống phân phối của máy (khách hàng) cục bộ của bạn. Bạn có thể
sau đó xử lý thư đã truy xuất bằng cách sử dụng các tác nhân người dùng thư thông thường, chẳng hạn như người đần độn(1) cây du(1) hoặc
email(1). Các nhận thư tiện ích có thể được chạy trong chế độ daemon để thăm dò liên tục một hoặc nhiều
hệ thống tại một khoảng thời gian xác định.

nhận thư chương trình có thể thu thập thư từ các máy chủ hỗ trợ bất kỳ thư chung nào-
giao thức truy xuất: POP2 (kế thừa, sẽ bị xóa khỏi bản phát hành trong tương lai), POP3, IMAP2bis,
IMAP4 và IMAP4rev1. Nó cũng có thể sử dụng phần mở rộng ESMTP ETRN và ODMR. (RFCs
mô tả tất cả các giao thức này được liệt kê ở cuối trang hướng dẫn sử dụng này.)

Trong khi nhận thư chủ yếu nhằm mục đích được sử dụng qua các liên kết TCP / IP theo yêu cầu (chẳng hạn như SLIP
hoặc các kết nối PPP), nó cũng có thể hữu ích như một tác nhân truyền thông điệp cho các trang web
từ chối vì lý do bảo mật cho phép giao dịch SMTP (do người gửi khởi xướng) với sendmail.

ỦNG HỘ, Giải đáp thắc mắc
Để khắc phục sự cố, theo dõi và gỡ lỗi, bạn cần phải tăng độ chi tiết của thư tìm nạp lên
thực sự xem những gì sẽ xảy ra. Để làm điều đó, hãy chạy cả hai of các hai tiếp theo lệnh,
thêm tất cả các of các lựa chọn bạn Thông thường sử dụng.

viv LC_ALL = C fetchmail -V -v --nodetach --nosyslog

(Dòng lệnh này in bằng tiếng Anh cách fetchmail hiểu cấu hình của bạn.)

viv LC_ALL = C fetchmail -vvv --nodetach --nosyslog

(Dòng lệnh này thực sự chạy thư tìm nạp với đầu ra bằng tiếng Anh dài dòng.)

Đồng thời xem mục # G3 trong Câu hỏi thường gặp của fetchmail ⟨http://fetchmail.berlios.de/fetchmail-FAQ.html# G3⟩

Bạn có thể bỏ qua phần LC_ALL = C ở trên nếu bạn muốn đầu ra bằng ngôn ngữ địa phương (nếu
được hỗ trợ). Tuy nhiên, nếu bạn đang đăng lên danh sách gửi thư, hãy để nó trong.
người bảo trì không nhất thiết phải hiểu ngôn ngữ của bạn, vui lòng sử dụng tiếng Anh.

CÁC KHÁI NIỆM
If nhận thư được sử dụng với máy chủ POP hoặc IMAP (nhưng không phải với ETRN hoặc ODMR), nó có hai
các chế độ hoạt động cơ bản cho mỗi tài khoản người dùng mà từ đó nó truy xuất thư:
thả đơn- Và nhiều giọt-chế độ.

Ở chế độ singledrop,
nhận thư giả định rằng tất cả các thư trong tài khoản của người dùng (hộp thư) là nhằm mục đích
cho một người nhận duy nhất. Danh tính của người nhận sẽ được mặc định là
người dùng cục bộ hiện đang thực thi nhận thưhoặc sẽ cần được chỉ định rõ ràng
trong tệp cấu hình.

nhận thư sử dụng chế độ singledrop khi cấu hình fetchmailrc chứa tối đa
một đặc tả người dùng cục bộ duy nhất cho một tài khoản máy chủ nhất định.

Trong chế độ đa phông nền,
nhận thư giả sử rằng tài khoản máy chủ thư thực sự chứa thư dành cho
bất kỳ số lượng người nhận khác nhau. Vì vậy, nhận thư phải cố gắng suy luận
"người nhận phong bì" thích hợp từ tiêu đề thư của mỗi thư. Trong này
phương thức hoạt động, nhận thư gần giống như một đại lý chuyển thư (MTA).

Lưu ý rằng cả giao thức POP và IMAP đều không được thiết kế để sử dụng theo cách này,
và do đó thông tin về phong bì thường không có sẵn trực tiếp. ISP phải
lưu trữ thông tin phong bì trong một số tiêu đề thư và. ISP cũng phải lưu trữ
một bản sao của tin nhắn cho mỗi người nhận. Nếu một trong hai điều kiện không
đã hoàn thành, quá trình này không đáng tin cậy, bởi vì nhận thư sau đó phải dùng đến
đoán (những) người nhận thư thực sự. Điều này thường không thành công đối với
thư danh sách gửi thư và thư Bcc: d hoặc thư cho nhiều người nhận trong
miền.

nhận thư sử dụng chế độ đa phông nền khi có nhiều người dùng cục bộ và / hoặc ký tự đại diện
được chỉ định cho một tài khoản máy chủ cụ thể trong tệp cấu hình.

Trong các chế độ ETRN và ODMR,
những cân nhắc này không áp dụng, vì các giao thức này dựa trên SMTP,
cung cấp thông tin người nhận phong bì rõ ràng. Các giao thức này luôn hỗ trợ
nhiều người nhận.

Khi mỗi tin nhắn được truy xuất, nhận thư thường phân phối nó qua SMTP đến cổng 25 trên
nó đang chạy trên máy chủ (localhost), giống như nó đang được chuyển qua một máy tính bình thường
Liên kết TCP / IP. nhận thư cung cấp cho máy chủ SMTP với người nhận trên phong bì có nguồn gốc từ
cách được mô tả trước đây. Sau đó, thư sẽ được gửi theo MTA của bạn
quy tắc (Đại lý chuyển thư thường là gửi thư(8) thi(8), hoặc postfix(số 8)). Kêu gọi
MDA (Đại lý chuyển phát thư) của hệ thống là nhiệm vụ của MTA. Tất cả các kiểm soát giao hàng
cơ chế (chẳng hạn như .phía trước tệp) thường có sẵn thông qua hệ thống MTA và cục bộ của bạn
các đại lý giao hàng do đó sẽ được áp dụng như bình thường.

Nếu cấu hình thư tìm nạp của bạn đặt MDA cục bộ (xem tùy chọn --mda), nó sẽ được sử dụng
trực tiếp thay vì nói SMTP với cổng 25.

Nếu chương trình nạpmailconf có sẵn, nó sẽ hỗ trợ bạn trong việc thiết lập và chỉnh sửa
cấu hình fetchmailrc. Nó chạy trong hệ thống cửa sổ X và yêu cầu
ngôn ngữ Python và bộ công cụ Tk (với các liên kết Python) có mặt trên hệ thống của bạn. Nếu như
lần đầu tiên bạn thiết lập thư tìm nạp cho chế độ một người dùng, bạn nên sử dụng
Chế độ người mới. Chế độ chuyên gia cung cấp quyền kiểm soát hoàn toàn cấu hình thư tìm nạp, bao gồm
các tính năng multidrop. Trong cả hai trường hợp, nút 'Autoprobe' sẽ cho bạn biết nhiều nhất
giao thức có khả năng mà một máy chủ thư nhất định hỗ trợ và cảnh báo bạn về các vấn đề tiềm ẩn với điều đó
máy chủ.

CÁC VẤN ĐỀ CHUNG HOẠT ĐỘNG

Hành vi của nhận thư được kiểm soát bởi các tùy chọn dòng lệnh và một tệp điều khiển chạy,
~ / .fetchmailrc, cú pháp mà chúng tôi mô tả trong phần sau (tệp này là
nạpmailconf chỉnh sửa chương trình). Ghi đè tùy chọn dòng lệnh ~ / .fetchmailrc các tờ khai.

Mỗi tên máy chủ mà bạn chỉ định sau các tùy chọn trên dòng lệnh sẽ là
chất vấn. Nếu bạn không chỉ định bất kỳ máy chủ nào trên dòng lệnh, mỗi mục nhập 'thăm dò ý kiến' trong
~ / .fetchmailrc tệp sẽ được truy vấn.

Để tạo điều kiện cho việc sử dụng nhận thư trong các tập lệnh và đường ống, nó trả về một
mã thoát khi chấm dứt - xem MÃ XUẤT KHẨU bên dưới.

Các tùy chọn sau đây sửa đổi hành vi của nhận thư. Ít khi cần thiết phải chỉ định
bất kỳ cái nào trong số này khi bạn đã làm việc .fetchmailrc tập tin được thiết lập.

Hầu hết tất cả các tùy chọn đều có một từ khóa tương ứng có thể được sử dụng để khai báo chúng trong
.fetchmailrc tập tin.

Một số tùy chọn đặc biệt không được đề cập ở đây, nhưng thay vào đó sẽ được ghi lại trong các phần trên
XÁC THỰC và CHẾ ĐỘ DAEMON theo sau.

Tổng quan Các lựa chọn
-V | --phiên bản
Hiển thị thông tin phiên bản cho bản sao của bạn nhận thư. Không tìm nạp thư là
đã thực hiện. Thay vào đó, đối với mỗi máy chủ được chỉ định, tất cả thông tin tùy chọn
sẽ được tính toán nếu nhận thư đang kết nối với máy chủ đó được hiển thị. Không tí nào
không thể in được trong mật khẩu hoặc các tên chuỗi khác được hiển thị dưới dạng dấu gạch chéo ngược giống C
trình tự thoát. Tùy chọn này hữu ích để xác minh rằng các tùy chọn của bạn đã được đặt
theo cách bạn muốn.

-c | --đánh dấu
Trả lại mã trạng thái để cho biết liệu có thư đang chờ hay không
tìm nạp hoặc xóa thư (xem MÃ XUẤT XỨ bên dưới). Tùy chọn này tắt daemon
(trong đó nó sẽ vô dụng). Nó không hoạt động tốt với các truy vấn đến nhiều
và không hoạt động với ETRN hoặc ODMR. Nó sẽ trả về một dương tính giả nếu bạn
để lại thư đã đọc nhưng chưa xóa trong hộp thư máy chủ của bạn và giao thức tìm nạp của bạn không thể
nói với những tin nhắn được lưu giữ từ những tin nhắn mới. Điều này có nghĩa là nó sẽ hoạt động với IMAP, không hoạt động với
POP2 và đôi khi có thể bong ra theo POP3.

-s | --im lặng
Chế độ im lặng. Loại bỏ tất cả các thông báo tiến độ / trạng thái thường được gửi tới
đầu ra tiêu chuẩn trong quá trình tìm nạp (nhưng không ngăn chặn các thông báo lỗi thực tế). Các
--verbose tùy chọn ghi đè tùy chọn này.

-v | --dài dòng
Chế độ chi tiết. Tất cả các thông báo kiểm soát được chuyển giữa nhận thư và người gửi thư là
vọng đến stdout. Ghi đè - im lặng. Nhân đôi tùy chọn này (-v -v) gây ra thêm
thông tin chẩn đoán được in.

--nosoftbounce
(kể từ v6.3.10, Từ khóa: không đặt softbounce, kể từ v6.3.10)
Chế độ trả lại cứng. Tất cả các lỗi gửi vĩnh viễn khiến thư bị xóa khỏi
máy chủ ngược dòng, hãy xem "không có softbounce" bên dưới.

--softbounce
(kể từ v6.3.10, Từ khóa: đặt softbounce, kể từ v6.3.10)
Chế độ nảy nhẹ. Tất cả các lỗi gửi vĩnh viễn khiến các thư bị để lại trên
máy chủ ngược dòng nếu giao thức hỗ trợ điều đó. T tùy chọn is on by mặc định đến
phù hợp với mang tính lịch sử nhận thư tài liệu, và sẽ được thay đổi thành chế độ thoát mạnh trong
bản phát hành thư tìm nạp tiếp theo.

Xử lý Các lựa chọn
-a | --tất cả các | (từ v6.3.3) --tìm nạp
(Từ khóa: fetchall, kể từ v3.0)
Truy xuất cả thư cũ (đã xem) và thư mới từ máy chủ thư. Mặc định là
chỉ tìm nạp các thư mà máy chủ chưa được đánh dấu là đã nhìn thấy. Trong POP3, tùy chọn này cũng
buộc sử dụng RETR thay vì TOP. Lưu ý rằng truy xuất POP2 hoạt động như thể
--tất cả luôn bật (xem CÁC CHẾ ĐỘ THẤT BẠI RÚT LẠI bên dưới) và tùy chọn này không
làm việc với ETRN hoặc ODMR. Trong khi dòng lệnh -a và --all và rcfile tìm nạp
các tùy chọn đã được hỗ trợ trong một thời gian dài, tùy chọn dòng lệnh --fetchall là
được thêm vào v6.3.3.

-k | --giữ cho
(Từ khóa: keep)
Giữ các thư đã truy xuất trên máy chủ thư từ xa. Thông thường, các tin nhắn sẽ bị xóa
từ thư mục trên máy chủ thư sau khi chúng đã được truy xuất. Chỉ định
giữ tùy chọn khiến các thư đã truy xuất vẫn còn trong thư mục của bạn trên máy chủ thư.
Tùy chọn này không hoạt động với ETRN hoặc ODMR. Nếu được sử dụng với POP3, nó được khuyến khích
để chỉ định tùy chọn --uidl hoặc từ khóa uidl.

-K | --giữ
(Từ khóa: nokeep)
Xóa các thư đã truy xuất khỏi máy chủ thư từ xa. Tùy chọn này buộc được truy xuất
thư sẽ bị xóa. Nó có thể hữu ích nếu bạn đã chỉ định một giá trị mặc định giữ in
qua một vài thao tác đơn giản về .fetchmailrc. Tùy chọn này được bắt buộc với ETRN và ODMR.

-F | --tuôn ra
(Từ khóa: flush)
Chỉ POP3 / IMAP. Đây là một tùy chọn nguy hiểm và có thể gây mất thư khi sử dụng
không đúng cách. Nó xóa các thư cũ (đã xem) khỏi máy chủ thư trước khi truy xuất
các tin nhắn mới. Cảnh báo: Điều này có thể gây ra mất thư nếu bạn kiểm tra thư của mình với
khách hàng hơn so với thư tìm nạp và khiến thư tìm nạp xóa một thư mà nó chưa bao giờ
đã tìm nạp trước đó. Nó cũng có thể gây mất thư nếu máy chủ thư đánh dấu thư
được nhìn thấy sau khi truy xuất (máy chủ IMAP2). Bạn có thể không nên sử dụng tùy chọn này trong
tệp cấu hình của bạn. Nếu bạn sử dụng nó với POP3, bạn phải sử dụng tùy chọn 'uidl'.
Những gì bạn có thể muốn là cài đặt mặc định: nếu bạn không chỉ định '-k', thì
fetchmail sẽ tự động xóa tin nhắn sau khi gửi thành công.

--giới hạn
Chỉ POP3 / IMAP, kể từ phiên bản 6.3.0. Xóa các thư quá khổ khỏi máy chủ thư
trước khi lấy tin nhắn mới. Giới hạn kích thước phải được chỉ định riêng với
tùy chọn --limit. Tùy chọn này không hoạt động với ETRN hoặc ODMR.

Nghị định thư và Câu Hỏi Các lựa chọn
-p | --proto | - giao thức
(Từ khóa: proto [col])
Chỉ định giao thức để sử dụng khi giao tiếp với máy chủ thư từ xa. Nếu không
giao thức được chỉ định, mặc định là TỰ ĐỘNG. do đó có thể là một trong những điều sau:

TỰ ĐỘNG Thử IMAP, POP3 và POP2 (bỏ qua bất kỳ điều nào trong số này mà không hỗ trợ
được biên dịch trong).

POP2 Post Office Protocol 2 (kế thừa, sẽ bị xóa khỏi bản phát hành trong tương lai)

POP3 Giao thức Bưu điện 3

APOP Sử dụng POP3 với xác thực thử thách MD5 kiểu cũ. Được coi là không
chống lại các cuộc tấn công của người trung gian.

RPOP Sử dụng POP3 với xác thực RPOP.

KPOP Sử dụng POP3 với xác thực Kerberos V4 trên cổng 1109.

SDPS Sử dụng POP3 với các phần mở rộng SDPS của Demon Internet.

IMAP IMAP2bis, IMAP4 hoặc IMAP4rev1 (nhận thư tự động phát hiện của họ
khả năng).

ETRN Sử dụng tùy chọn ESMTP ETRN.

ODMR Sử dụng cấu hình ESMTP Chuyển tiếp Thư Theo yêu cầu.

Tất cả các lựa chọn thay thế này về cơ bản hoạt động theo cùng một cách (giao tiếp với máy chủ tiêu chuẩn
daemon để tìm nạp thư đã được gửi đến hộp thư trên máy chủ) ngoại trừ ETRN và ODMR.
Chế độ ETRN cho phép bạn yêu cầu máy chủ ESMTP tuân thủ (chẳng hạn như thư gửi BSD khi phát hành
8.8.0 hoặc cao hơn) để mở ngay kết nối người gửi-SMTP tới máy khách của bạn và
bắt đầu chuyển tiếp bất kỳ mục nào được gửi đến máy khách của bạn trong hàng đợi của máy chủ
thư chưa gửi. Chế độ ODMR yêu cầu máy chủ hỗ trợ ODMR và hoạt động tương tự như
ETRN, ngoại trừ việc nó không yêu cầu máy khách phải có DNS tĩnh.

-U | --uidl
(Từ khóa: uidl)
Buộc sử dụng UIDL (chỉ hiệu quả với POP3). Buộc theo dõi 'tính mới' từ phía khách hàng
của tin nhắn (UIDL là viết tắt của "danh sách ID duy nhất" và được mô tả trong RFC1939). Sử dụng
với 'keep' để sử dụng hộp thư làm nơi đăng tin mới cho một nhóm người dùng. Sự thật
thông báo đã thấy bị bỏ qua sẽ được ghi lại, trừ khi ghi nhật ký lỗi được thực hiện thông qua
nhật ký hệ thống trong khi chạy ở chế độ daemon. Lưu ý rằng thư tìm nạp có thể tự động bật
tùy chọn này tùy thuộc vào khả năng của máy chủ ngược dòng. Cũng lưu ý rằng tùy chọn này
có thể bị xóa và buộc phải bật trong phiên bản thư điện tử tìm nạp trong tương lai. Xem thêm:
--tệp.

--nhàn rỗi (từ 6.3.3)
(Từ khóa: nhàn rỗi, kể từ trước 6.0.0)
Bật sử dụng IDLE (chỉ hiệu quả với IMAP). Lưu ý rằng điều này chỉ hoạt động với một
thư mục tại một thời điểm nhất định. Trong khi từ khóa rcfile không hoạt động đã được hỗ trợ cho một
từ lâu, tùy chọn dòng lệnh --idle đã được thêm vào trong phiên bản 6.3.3. Sử dụng IDLE
nghĩa là thư tìm nạp yêu cầu máy chủ IMAP gửi thông báo về thư mới, vì vậy họ
có thể được truy xuất sớm hơn có thể với các cuộc thăm dò thông thường.

-P | --Dịch vụ
(Từ khóa: dịch vụ) Kể từ phiên bản 6.3.0.
Tùy chọn dịch vụ cho phép bạn chỉ định tên dịch vụ để kết nối. Bạn có thể
chỉ định số cổng thập phân ở đây, nếu cơ sở dữ liệu dịch vụ của bạn thiếu yêu cầu
chuyển nhượng cổng dịch vụ. Xem mục Câu hỏi thường gặp R12 và tài liệu --ssl cho
thông tin chi tiết. Điều này thay thế tùy chọn --port cũ hơn.

--Hải cảng
(Từ khóa: cổng)
Phiên bản lỗi thời của --service không có tên dịch vụ. Lưu ý: tùy chọn này
có thể bị xóa khỏi phiên bản trong tương lai.

--hiệu trưởng
(Từ khóa: chính)
Tùy chọn chính cho phép bạn chỉ định một dịch vụ chính cho hai bên
xác thực. Điều này có thể áp dụng cho POP3 hoặc IMAP với xác thực Kerberos 4
chỉ một. Nó không áp dụng cho Kerberos 5 hoặc GSSAPI. Tùy chọn này có thể bị xóa trong
phiên bản tìm nạp trong tương lai.

-t | --hết giờ
(Từ khóa: hết giờ)
Tùy chọn thời gian chờ cho phép bạn đặt thời gian chờ máy chủ không phản hồi tính bằng giây. Nếu một
máy chủ thư không gửi một tin nhắn chào mừng hoặc phản hồi các lệnh cho
số giây, nhận thư sẽ bỏ kết nối với nó. Nếu không có một
thời gian chờ nhận thư có thể bị treo cho đến khi hết thời gian kết nối TCP, đang cố gắng tìm nạp
thư từ máy chủ lưu trữ, có thể rất dài. Điều này sẽ đặc biệt khó chịu
cho một nhận thư chạy trong nền. Có thời gian chờ mặc định
fetchmail -V sẽ báo cáo. Nếu một kết nối nhất định nhận được quá nhiều thời gian chờ trong
kế tiếp, fetchmail sẽ coi nó đã được nêm và ngừng thử lại. Người dùng đang gọi điện
sẽ được thông báo qua email nếu điều này xảy ra.

Bắt đầu với thư tìm nạp 6.3.10, ứng dụng khách SMTP sử dụng mức tối thiểu được khuyến nghị
hết thời gian chờ từ RFC-5321 trong khi chờ máy chủ SMTP / LMTP mà nó đang nói chuyện.
Bạn có thể tăng thời gian chờ nhiều hơn, nhưng bạn không thể rút ngắn chúng. Điều này là để tránh
một tình huống khó khăn trong đó thư tìm nạp đã được định cấu hình với thời gian chờ ngắn (a
phút hoặc ít hơn), gửi một tin nhắn dài (nhiều MByte) đến MTA cục bộ, sau đó
mất nhiều thời gian hơn thời gian chờ để trả lời "OK", điều này cuối cùng sẽ xảy ra; mà có
nghĩa là thư được gửi đúng cách, nhưng thư tìm nạp không thể nhận thấy nó và do đó sẽ
tìm nạp lại thông điệp lớn này nhiều lần.

--cắm vào
(Từ khóa: plugin)
Tùy chọn plugin cho phép bạn sử dụng chương trình bên ngoài để thiết lập TCP
sự liên quan. Điều này rất hữu ích nếu bạn muốn sử dụng ssh hoặc cần một số đặc biệt
thiết lập tường lửa. Chương trình sẽ được tra cứu trong $ PATH và có thể tùy chọn
đã chuyển tên máy chủ và cổng làm đối số bằng cách sử dụng "% h" và "% p" tương ứng (lưu ý
rằng logic nội suy là khá nguyên thủy và các mã thông báo này phải được giới hạn
bởi khoảng trắng hoặc đầu chuỗi hoặc cuối chuỗi). Fetchmail sẽ viết thư tới
stdin của plugin và đọc từ stdout của plugin.

--rút ra
(Từ khóa: plugout)
Giống với tùy chọn plugin ở trên, nhưng tùy chọn này được sử dụng cho SMTP


-r | --thư mục
(Từ khóa: thư mục [s])
Gây ra một thư mục thư không mặc định được chỉ định trên máy chủ thư (hoặc được phân tách bằng dấu phẩy
danh sách các thư mục) được truy xuất. Cú pháp của tên thư mục là server-
sự phụ thuộc. Tùy chọn này không khả dụng theo POP3, ETRN hoặc ODMR.

--tracepolls
(Từ khóa: tracepolls)
Yêu cầu fetchmail thăm dò thông tin theo dõi trong biểu mẫu 'tài khoản bỏ phiếu% s' và
'thư mục% s' đến dòng Đã nhận mà nó tạo ra, trong đó các phần% s được thay thế bằng
tên từ xa của người dùng, nhãn thăm dò ý kiến ​​và thư mục (hộp thư) nếu có
(tiêu đề Đã nhận cũng thường bao gồm tên thật của máy chủ). Điều này có thể là
được sử dụng để hỗ trợ lọc thư dựa trên tài khoản mà nó đang được nhận.
Thông tin thư mục chỉ được ghi từ phiên bản 6.3.4.

--ssl (Từ khóa: ssl)
Làm cho kết nối với máy chủ thư được mã hóa qua SSL, bằng cách thương lượng
SSL trực tiếp sau khi kết nối (chế độ SSL bọc). Nó rất khuyến khích để sử dụng
--sslcertck để xác thực các chứng chỉ do máy chủ cung cấp. Xin vui lòng xem
mô tả của --sslproto bên dưới! Thông tin thêm có sẵn trong README.SSL
tệp được gửi với thư tìm nạp.

Lưu ý rằng ngay cả khi tùy chọn này bị bỏ qua, thư tìm nạp vẫn có thể thương lượng SSL trong băng tần
cho POP3 hoặc IMAP, thông qua tính năng STLS hoặc STARTTLS. Bạn có thể sử dụng --sslproto
tùy chọn để sửa đổi hành vi đó.

Nếu không có cổng nào được chỉ định, kết nối sẽ được cố gắng kết nối với cổng nổi tiếng của
Phiên bản SSL của giao thức cơ sở. Đây thường là một cổng khác với cổng
được sử dụng bởi giao thức cơ sở. Đối với IMAP, đây là cổng 143 cho giao thức rõ ràng và
cổng 993 cho giao thức bảo mật SSL; đối với POP3, đó là cổng 110 cho văn bản rõ ràng
và cổng 995 cho biến thể được mã hóa.

Nếu hệ thống của bạn thiếu các mục nhập tương ứng từ / etc / services, xem
- tùy chọn dịch vụ và chỉ định số cổng như đã cho ở phần trước
đoạn văn (trừ khi ISP của bạn đã hướng bạn đến các cổng khác nhau, điều này không phổ biến
Tuy nhiên).

--sslcert
(Từ khóa: sslcert)
Để xác thực máy khách dựa trên chứng chỉ. Một số máy chủ được mã hóa SSL yêu cầu
các khóa và chứng chỉ phía máy khách để xác thực. Trong hầu hết các trường hợp, đây là
không bắt buộc. Điều này chỉ định vị trí của chứng chỉ khóa công khai là
được trình bày cho máy chủ tại thời điểm phiên SSL được thiết lập. Không phải vậy
bắt buộc (nhưng có thể được cung cấp) nếu máy chủ không yêu cầu. Nó có thể là
cùng một tệp với khóa cá nhân (khóa kết hợp và tệp chứng chỉ) nhưng đây không phải là
khuyến khích. Cũng xem --sslkey bên dưới.

LƯU Ý: Nếu bạn sử dụng xác thực ứng dụng khách, tên người dùng được tải xuống từ
CommonName của chứng chỉ và ghi đè tên được đặt bằng --user.

--sslkey
(Từ khóa: sslkey)
Chỉ định tên tệp của khóa SSL riêng tư phía máy khách. Một số SSL được mã hóa
máy chủ yêu cầu các khóa và chứng chỉ phía máy khách để xác thực. Ở hầu hết các
trường hợp này là tùy chọn. Điều này chỉ định vị trí của khóa cá nhân được sử dụng để
ký giao dịch với máy chủ tại thời điểm phiên SSL được thiết lập. Nó
không bắt buộc (nhưng có thể được cung cấp) nếu máy chủ không yêu cầu. Nó có thể
cùng một tệp với khóa công khai (khóa kết hợp và tệp chứng chỉ) nhưng đây không phải là
khuyến khích.

Nếu mật khẩu được yêu cầu để mở khóa, nó sẽ được nhắc vào lúc đó
ngay trước khi thiết lập phiên tới máy chủ. Điều này có thể gây ra một số
các biến chứng trong chế độ daemon.

Cũng xem --sslcert ở trên.

--sslproto
(Từ khóa: sslproto, LƯU Ý: thay đổi ngữ nghĩa kể từ v6.4.0)
Tùy chọn này có chức năng sử dụng kép, ngoài hành vi tìm nạp thư trước đây. Nó kiểm soát cả hai
phiên bản giao thức SSL / TLS và nếu --ssl không được chỉ định thì hành vi STARTTLS
(nâng cấp giao thức lên kết nối SSL hoặc TLS trong băng tần). Một số tùy chọn khác
tuy nhiên có thể làm cho TLS bắt buộc.

Chỉ khi tùy chọn này và --ssl đều bị thiếu trong một cuộc thăm dò ý kiến, thì sẽ có TLS cơ hội
cho POP3 và IMAP, trong đó thư điện tử tìm nạp sẽ cố gắng nâng cấp lên TLSv1 hoặc mới hơn.

Các giá trị được công nhận cho --sslproto được đưa ra bên dưới. Bạn thường nên chọn một trong các
các tùy chọn thương lượng tự động, tức là 'tự động'hoặc một trong các tùy chọn kết thúc bằng dấu cộng (+)
tính cách. Lưu ý rằng tùy thuộc vào cấu hình và phiên bản thư viện OpenSSL, một số tùy chọn
gây ra lỗi thời gian chạy vì các phiên bản SSL hoặc TLS được yêu cầu không được hỗ trợ bởi
thư viện OpenSSL được cài đặt cụ thể.

'', chuỗi trống
Tắt STARTTLS. Nếu --ssl được cung cấp cho cùng một máy chủ, ghi lại lỗi và
giả vờ như vậy 'tự động'đã được sử dụng thay thế.

'tự động' (vỡ nợ). Kể từ v6.4.0. Yêu cầu TLS. Tự động thương lượng TLSv1 hoặc mới hơn, vô hiệu hóa
Hạ cấp SSLv3. (fetchmail 6.3.26 trở lên đã tự động thương lượng tất cả
giao thức mà thư viện OpenSSL của họ hỗ trợ, bao gồm cả SSLv3 bị hỏng).

'SSL23'
Thấy chưa 'tự động'.

'SSL3'Yêu cầu chính xác SSLv3. SSLv3 bị hỏng, không được hỗ trợ trên tất cả các hệ thống, tránh
nếu có thể. Điều này sẽ làm cho thư tìm nạp chỉ thương lượng SSLv3 và là
cách duy nhất bên cạnh 'SSL3 +'để có thư điện tử tìm nạp 6.4.0 hoặc mới hơn cho phép SSLv3.

'SSL3 +'
giống như 'tự động', nhưng cũng cho phép SSLv3. Đây là cách duy nhất bên cạnh
'SSL3'để có thư điện tử tìm nạp 6.4.0 hoặc mới hơn cho phép SSLv3.

'TLS1'Yêu cầu TLSv1. Điều này không thương lượng TLSv1.1 hoặc mới hơn và không được khuyến khích.
Thay thế bằng TLS1 + trừ khi TLSXNUMX + làm nghẽn máy chủ của bạn.

'TLS1 +'
Kể từ v6.4.0. Xem 'fBauto'.

'TLS1.1'
Kể từ v6.4.0. Yêu cầu chính xác TLS v1.1.

'TLS1.1 +'
Kể từ v6.4.0. Yêu cầu TLS. Tự động thương lượng TLSv1.1 hoặc mới hơn.

'TLS1.2'
Kể từ v6.4.0. Yêu cầu chính xác TLS v1.2.

'TLS1.2 +'
Kể từ v6.4.0. Yêu cầu TLS. Tự động thương lượng TLSv1.2 hoặc mới hơn.

Các thông số không được công nhận
được đối xử giống như 'tự động'.

LƯU Ý: bạn hầu như không cần sử dụng bất kỳ thứ gì khác ngoài '' (để buộc
kết nối không được mã hóa) hoặc 'tự động' (để thực thi TLS).

--sslcertck
(Từ khóa: sslcertck)
Khiến thư tìm nạp yêu cầu sử dụng SSL / TLS và ngắt kết nối nếu không thể
thương lượng thành công SSL hoặc TLS hoặc nếu nó không thể xác minh và xác thực thành công
chứng chỉ và theo sau nó đến một neo tin cậy (hoặc chứng chỉ gốc đáng tin cậy). Các
neo tin cậy được cung cấp dưới dạng một tập hợp các chứng chỉ đáng tin cậy cục bộ (xem tập tin sslcert
và sslcertpath tùy chọn). Nếu không thể lấy được chứng chỉ máy chủ hoặc không
được ký bởi một trong những người đáng tin cậy (trực tiếp hoặc gián tiếp), fetchmail sẽ
ngắt kết nối, bất kể ssldấu vân tay tùy chọn.

Lưu ý rằng CRL (danh sách thu hồi chứng chỉ) chỉ được hỗ trợ trong OpenSSL 0.9.7
và mới hơn! Đồng hồ hệ thống của bạn cũng phải chính xác hợp lý khi sử dụng
tùy chọn.

Lưu ý rằng hành vi tùy chọn này có thể trở thành hành vi mặc định trong thư tìm nạp trong tương lai
phiên bản.

--sslcertfile
(Từ khóa: sslcertfile, kể từ v6.3.17)
Đặt tệp tìm nạp sử dụng để tra cứu chứng chỉ cục bộ. Giá trị mặc định là trống.
Điều này có thể được đưa ra ngoài --sslcertpath dưới đây và các chứng chỉ được chỉ định trong
--sslcertfile sẽ được xử lý trước khi những người trong --sslcertpath. Tùy chọn có thể là
được sử dụng ngoài --sslcertpath.

Tệp là tệp văn bản. Nó chứa nối các chứng chỉ CA đáng tin cậy
ở định dạng PEM.

Lưu ý rằng việc sử dụng tùy chọn này sẽ ngăn tải CA tin cậy SSL mặc định
tệp chứng chỉ trừ khi bạn đặt biến môi trường
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS thành một giá trị không trống.

--sslcertpath
(Từ khóa: sslcertpath)
Đặt thư mục fetchmail sử dụng để tra cứu các chứng chỉ cục bộ. Mặc định là
thư mục mặc định OpenSSL của bạn. Thư mục phải được băm theo cách OpenSSL
mong đợi điều đó - mỗi khi bạn thêm hoặc sửa đổi chứng chỉ trong thư mục, bạn cần
sử dụng c_rehash công cụ (đi kèm với OpenSSL trong công cụ / thư mục con).
Ngoài ra, sau khi nâng cấp OpenSSL, bạn có thể cần chạy c_rehash; đặc biệt là khi
nâng cấp từ 0.9.X lên 1.0.0.

Điều này có thể được đưa ra ngoài --sslcertfile ở trên, được ưu tiên
quy tắc.

Lưu ý rằng việc sử dụng tùy chọn này sẽ ngăn chặn việc thêm CA tin cậy SSL mặc định
thư mục chứng chỉ trừ khi bạn đặt biến môi trường
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS thành một giá trị không trống.

--sslcommonname <chung tên>
(Từ khóa: sslcommonname; kể từ v6.3.9)
Không khuyến khích sử dụng tùy chọn này. Trước khi sử dụng nó, hãy liên hệ với quản trị viên của
máy chủ ngược dòng của bạn và yêu cầu sử dụng chứng chỉ SSL thích hợp. Nếu điều đó
không thể đạt được, tùy chọn này có thể được sử dụng để chỉ định tên (CommonName)
fetchmail mong đợi trên chứng chỉ máy chủ. Một máy chủ được định cấu hình đúng sẽ
đặt tên này thành tên máy chủ mà nó được tiếp cận và theo mặc định, thư tìm nạp sẽ
mong đợi càng nhiều. Sử dụng tùy chọn này khi Tên chung được đặt thành một số giá trị khác, thành
tránh cảnh báo "Tên chung máy chủ không khớp" và chỉ khi máy chủ ngược dòng
không thể được thực hiện để sử dụng các chứng chỉ thích hợp.

--ssldấu vân tay
(Từ khóa: sslfingerprint)
Chỉ định dấu vân tay của khóa máy chủ (băm MD5 của khóa) ở hệ thập lục phân
ký hiệu bằng dấu hai chấm phân cách các nhóm có hai chữ số. Chữ số hex chữ cái phải là
trong trường hợp viết hoa. Đây là định dạng mà thư tìm nạp sử dụng để báo cáo tệp tham chiếu
khi kết nối SSL được thiết lập. Khi điều này được chỉ định, thư tìm nạp sẽ
so sánh vân tay của khóa máy chủ với vân tay đã cho và kết nối sẽ không thành công
nếu chúng không khớp, bất kể sslcertck thiết lập. Kết nối cũng sẽ
thất bại nếu thư tìm nạp không thể lấy chứng chỉ SSL từ máy chủ. Điều này có thể là
được sử dụng để ngăn chặn các cuộc tấn công man-in-the-middle, nhưng dấu vân tay từ máy chủ
cần được lấy hoặc xác minh qua một kênh an toàn và chắc chắn không qua
cùng một kết nối Internet mà tìm nạp thư sẽ sử dụng.

Sử dụng tùy chọn này sẽ ngăn lỗi xác minh chứng chỉ in miễn là
--sslcertck chưa được đặt.

Để lấy tệp tham chiếu của chứng chỉ được lưu trữ trong tệp cert.pem, hãy thử:

openssl x509 -in cert.pem -noout -md5 - dấu vân tay

Để biết chi tiết, xem x509(1ssl).

Giao hàng tận nơi Kiểm soát Các lựa chọn
-S | --smtphost
(Từ khóa: smtp [máy chủ])
Chỉ định một danh sách săn tìm các máy chủ để chuyển tiếp thư tới (một hoặc nhiều tên máy chủ, dấu phẩy-
ly thân). Máy chủ được thử theo thứ tự danh sách; cái đầu tiên được nâng lên trở thành
mục tiêu chuyển tiếp cho lần chạy hiện tại. Nếu tùy chọn này không được chỉ định,
'localhost' được sử dụng làm mặc định. Mỗi tên máy chủ có thể có một số cổng sau
tên máy chủ. Số cổng được phân tách khỏi tên máy chủ bằng một dấu gạch chéo; NS
cổng mặc định là "smtp". Nếu bạn chỉ định tên đường dẫn tuyệt đối (bắt đầu bằng dấu /),
nó sẽ được hiểu là tên của ổ cắm UNIX chấp nhận các kết nối LMTP
(chẳng hạn như được hỗ trợ bởi trình nền Cyrus IMAP) Ví dụ:

--smtphost server1, server2 / 2525, server3, / var / imap / socket / lmtp

Tùy chọn này có thể được sử dụng với ODMR và sẽ làm cho thư tìm nạp trở thành một chuyển tiếp giữa ODMR
máy chủ và bộ thu SMTP hoặc LMTP.

--tìm nạp tên miền
(Từ khóa: tên miền tìm nạp)
Trong chế độ ETRN hoặc ODMR, tùy chọn này chỉ định danh sách các miền mà máy chủ nên
gửi thư cho một khi kết nối được quay lại. Mặc định là FQDN của
máy chạy nhận thư.

-D | --smtpaddress
(Từ khóa: smtpaddress)
Chỉ định miền sẽ được nối vào các địa chỉ trong dòng RCPT TO được chuyển đến SMTP.
Khi điều này không được chỉ định, tên của máy chủ SMTP (như được chỉ định bởi
--smtphost) được sử dụng cho SMTP / LMTP và 'localhost' được sử dụng cho ổ cắm UNIX / BSMTP.

--smtpname
(Từ khóa: smtpname)
Chỉ định miền và người dùng được đưa vào các dòng RCPT TO được chuyển đến SMTP. Các
người dùng mặc định là người dùng cục bộ hiện tại.

-Z | --chống thư rác <nnn[, nnn] ...>
(Từ khóa: chống thư rác)
Chỉ định danh sách các lỗi SMTP số sẽ được hiểu là một thư rác-
chặn phản hồi từ người nghe. Giá trị -1 sẽ tắt tùy chọn này. Cho
tùy chọn dòng lệnh, các giá trị danh sách phải được phân tách bằng dấu phẩy.

-m | --mda
(Từ khóa: mda)
Tùy chọn này cho phép nhận thư sử dụng Tin nhắn hoặc Đại lý phân phối địa phương (MDA hoặc LDA)
trực tiếp, thay vì chuyển tiếp qua SMTP hoặc LMTP.

Để tránh mất thư, chỉ sử dụng tùy chọn này với MDA như maildrop hoặc MTA như
sendmail thoát với trạng thái nonzero trên đĩa đầy và các lỗi gửi khác;
trạng thái nonzero cho biết tìm nạp thư rằng gửi không thành công và ngăn thư
khỏi bị xóa trên máy chủ.

If nhận thư đang chạy dưới quyền root, nó đặt id người dùng của nó trong khi gửi thư qua
một MDA như sau: Đầu tiên, môi trường FETCHMAILUSER, LOGNAME và USER
các biến được kiểm tra theo thứ tự này. Giá trị của biến đầu tiên từ danh sách của anh ấy
được xác định (ngay cả khi nó trống!) được tra cứu trong cơ sở dữ liệu người dùng hệ thống. Nếu như
không có biến nào được xác định, fetchmail sẽ sử dụng id người dùng thực mà nó đã từng là
bắt đầu với. Nếu một trong các biến đã được xác định, nhưng người dùng nói rằng không có
tìm thấy, fetchmail tiếp tục chạy dưới dạng thư mục gốc, mà không cần kiểm tra các biến còn lại trên
danh sách. Thực tế, điều này có nghĩa là nếu bạn chạy fetchmail dưới dạng root (không phải
được khuyến nghị), hữu ích nhất là xác định biến môi trường FETCHMAILUSER thành
đặt người dùng mà MDA sẽ chạy. Một số MDA (chẳng hạn như maildrop) được thiết kế
được setuid root và setuid thành id người dùng của người nhận, vì vậy bạn không bị mất
hoạt động theo cách này ngay cả khi chạy thư tìm nạp với tư cách người dùng không có đặc quyền. Kiểm tra
Hướng dẫn sử dụng của MDA để biết thêm chi tiết.

Một số MDA có thể là "/ usr / sbin / sendmail -i -f% F -% T "(Lưu ý: một số
các phiên bản sendmail cũ hơn hoặc của nhà cung cấp bị nhầm lẫn - cho một địa chỉ, thay vì một
chỉ báo để đánh dấu sự kết thúc của các đối số tùy chọn), "/ usr / bin / delivery" và
"/ usr / bin / maildrop -d% T". Địa chỉ giao hàng địa phương sẽ được chèn vào MDA
lệnh bất cứ nơi nào bạn đặt% T; địa chỉ Từ của thư sẽ được chèn
nơi bạn đặt% F.

Do KHÔNG bao bọc các %F or %T chuỗi in duy nhất dấu ngoặc kép! Đối với cả% T và% F, tìm nạp thư
đặt các địa chỉ trong dấu nháy đơn ('), sau khi xóa bất kỳ dấu nháy đơn nào, chúng
có thể chứa, trước khi lệnh MDA được chuyển tới trình bao.

Do KHÔNG sử dụng an MDA sự cầu khẩn việc này công văn on các nội dung of Tới / Cc / Bcc, Lượt thích
"sendmail -i -t" hoặc "qmail-injection", nó sẽ tạo các vòng lặp thư và mang lại
cơn thịnh nộ của nhiều người đưa thư xuống đầu bạn. Đây là một trong những điều thường xuyên nhất
lỗi cấu hình!

Cũng làm không cố gắng kết hợp chế độ đa phông nền với một MDA chẳng hạn như phông nền thư có thể
chỉ chấp nhận một địa chỉ, trừ khi phía trên của bạn lưu trữ một bản sao của thư cho mỗi
người nhận và chuyển người nhận phong bì trong một tiêu đề; bạn sẽ mất thư.

Hạnh được biết đến gửi thư(1) gói rất khó để định cấu hình đúng cách, nó có một
hành vi "chuyển sang quy tắc tiếp theo" rất khó chịu đối với lỗi phân phối (thậm chí
những cái tạm thời, chẳng hạn như hết dung lượng đĩa nếu daemon thư của người dùng khác sao chép
hộp thư xung quanh để xóa các thư cũ), vì vậy thư của bạn sẽ kết thúc sai
hộp thư sớm muộn. Cấu hình procmail thích hợp nằm ngoài phạm vi của
tài liệu này. Sử dụng thư thả(1) thường dễ dàng hơn nhiều và nhiều người dùng nhận thấy
cú pháp lọc được sử dụng bởi maildrop dễ hiểu hơn.

Cuối cùng, chúng tôi đặc biệt khuyên bạn nên không sử dụng qmail-injection. Dòng lệnh
giao diện không chuẩn mà không mang lại lợi ích cho việc sử dụng thông thường và tìm nạp thư
không cố gắng điều chỉnh độ lệch của qmail-injection so với tiêu chuẩn. Một vài
các tùy chọn dòng lệnh và môi trường của qmail-injection thực sự nguy hiểm và
có thể gây ra các chuỗi bị hỏng, các thư trùng lặp không được phát hiện và các vòng chuyển tiếp.

--lmtp (Từ khóa: lmtp)
Nguyên nhân gửi qua LMTP (Giao thức chuyển thư cục bộ). Một máy chủ dịch vụ và cổng
phải được chỉ định rõ ràng trên từng máy chủ trong danh sách tìm kiếm smtphost (xem ở trên) nếu
tùy chọn này được chọn; cổng mặc định 25 sẽ (phù hợp với RFC 2033) không
Được chấp nhận.

--bsmtp
(Từ khóa: bsmtp)
Nối thư đã tìm nạp vào tệp BSMTP. Điều này chỉ đơn giản là chứa các lệnh SMTP
thường sẽ được tạo bởi thư tìm nạp khi chuyển thư đến trình nghe SMTP
yêu tinh.

Đối số của '-' khiến lô SMTP được ghi vào đầu ra tiêu chuẩn, đó là
sử dụng hạn chế: điều này chỉ có ý nghĩa đối với việc gỡ lỗi, bởi vì fetchmail thường xuyên
đầu ra được xen kẽ trên cùng một kênh, vì vậy điều này không phù hợp với thư
chuyển. Chế độ đặc biệt này có thể bị xóa trong bản phát hành sau.

Lưu ý rằng việc tạo lại các dòng MAIL FROM và RCPT TO của fetchmail không phải là
đảm bảo chính xác; những lưu ý được thảo luận trong VIỆC SỬ DỤNG VÀ LẠM DỤNG ĐA NĂNG LƯỢNG
MAILBOXES dưới đây được áp dụng. Chế độ này được ưu tiên trước --mda và SMTP / LMTP.

--tiêu đề xấu {từ chối | chấp nhận}
(Từ khóa: bad-header; kể từ v6.3.15)
Chỉ định cách thư điện tử tìm nạp phải xử lý các thư có tiêu đề xấu, tức là tiêu đề
với cú pháp sai. Theo truyền thống, fetchmail đã từ chối những tin nhắn như vậy, nhưng một số
nhà phân phối đã sửa đổi fetchmail để chấp nhận chúng. Bây giờ bạn có thể định cấu hình thư tìm nạp của
hành vi trên mỗi máy chủ.

Tài nguyên Giới Hạn Kiểm soát Các lựa chọn
-l | --giới hạn
(Từ khóa: giới hạn)
Lấy đối số kích thước bộ tám tối đa, trong đó 0 là giá trị mặc định và cũng là giá trị đặc biệt
giá trị chỉ định "không có giới hạn". Nếu khác không, các thư lớn hơn kích thước này sẽ không
được tìm nạp và sẽ được để lại trên máy chủ (trong các phiên nền trước, tiến trình
tin nhắn sẽ lưu ý rằng chúng "quá khổ"). Nếu giao thức tìm nạp cho phép (trong
đặc biệt, trong IMAP hoặc POP3 mà không có tùy chọn tìm nạp) thì thông báo sẽ không
đánh dấu đã thấy.

--Giới hạn 0 rõ ràng sẽ ghi đè lên bất kỳ giới hạn nào được đặt trong tệp điều khiển chạy của bạn. Cái này
tùy chọn dành cho những người cần kiểm soát chặt chẽ thời gian tìm nạp do
giá điện thoại đắt và thay đổi.

Kết hợp với --limitflush, nó có thể được sử dụng để xóa các tin nhắn quá khổ đang chờ
Một máy chủ. Trong chế độ daemon, thông báo quá khổ được gửi qua thư đến người dùng đang gọi
(xem tùy chọn - cảnh báo). Tùy chọn này không hoạt động với ETRN hoặc ODMR.

-w | - cảnh báo
(Từ khóa: cảnh báo)
Mất khoảng thời gian tính bằng giây. Khi bạn gọi nhận thư với một tùy chọn 'giới hạn' trong
chế độ daemon, điều này kiểm soát khoảng thời gian cảnh báo về các thông báo quá khổ
được gửi qua thư cho người dùng đang gọi (hoặc người dùng được chỉ định bởi tùy chọn 'quản trị viên bưu điện').
Một thông báo như vậy luôn được gửi qua thư vào cuối cuộc thăm dò ý kiến ​​đầu tiên mà
tin nhắn quá khổ được phát hiện. Sau đó, thông báo lại bị chặn cho đến khi
sau khi khoảng thời gian cảnh báo kết thúc (nó sẽ diễn ra vào cuối khoảng thời gian đầu tiên
cuộc thăm dò sau).

-b | --batchlimit
(Từ khóa: batchlimit)
Chỉ định số lượng tin nhắn tối đa sẽ được chuyển đến trình nghe SMTP
trước khi kết nối bị cố tình chia nhỏ và xây dựng lại (mặc định là 0, nghĩa là
không giới hạn). --Batchlimit rõ ràng bằng 0 ghi đè lên bất kỳ giới hạn nào được đặt trong quá trình chạy của bạn
tệp điều khiển. Trong khi gửi thư(8) thường bắt đầu gửi một tin nhắn
ngay sau khi nhận được trình kết thúc tin nhắn, một số người nghe SMTP không như vậy
lời nhắc. MTA như Chửi mắng(8) có thể đợi cho đến khi ổ cắm giao hàng tắt để
giao. Điều này có thể gây ra sự chậm trễ khó chịu khi nhận thư đang xử lý rất lớn
hàng loạt. Đặt giới hạn hàng loạt thành một số kích thước khác không sẽ ngăn chặn những sự chậm trễ này.
Tùy chọn này không hoạt động với ETRN hoặc ODMR.

-B | --fetchlimit
(Từ khóa: fetchlimit)
Giới hạn số lượng thư được chấp nhận từ một máy chủ nhất định trong một cuộc thăm dò. Qua
mặc định không có giới hạn. Một --fetchlimit rõ ràng bằng 0 sẽ ghi đè lên bất kỳ giới hạn nào đã đặt
trong tệp điều khiển chạy của bạn. Tùy chọn này không hoạt động với ETRN hoặc ODMR.

--fetchsizelimit
(Từ khóa: fetchsizelimit)
Giới hạn số lượng kích thước thư được chấp nhận từ một máy chủ nhất định trong một lần duy nhất
Giao dịch. Tùy chọn này hữu ích trong việc giảm sự chậm trễ trong việc tải xuống đầu tiên
gửi thư khi có quá nhiều thư trong hộp thư. Theo mặc định, giới hạn là 100.
Nếu được đặt thành 0, kích thước của tất cả các thư sẽ được tải xuống ngay từ đầu. Tùy chọn này không
không hoạt động với ETRN hoặc ODMR. Đối với POP3, giá trị khác 1 hợp lệ duy nhất là XNUMX.

--fastuidl
(Từ khóa: fastuidl)
Thực hiện tìm kiếm nhị phân thay vì tìm kiếm tuyến tính cho UID chưa thấy đầu tiên. Tìm kiếm nhị phân tránh
tải xuống UID của tất cả các thư. Điều này tiết kiệm thời gian (đặc biệt là trong chế độ daemon)
trong đó việc tải xuống cùng một bộ UID trong mỗi cuộc thăm dò sẽ gây lãng phí băng thông. Các
số 'n' cho biết mức độ hiếm khi thực hiện tìm kiếm tuyến tính. Trong chế độ daemon,
tìm kiếm tuyến tính được sử dụng sau khi tìm kiếm nhị phân theo sau trong các cuộc thăm dò 'n-1' nếu 'n' là
lớn hơn 1; tìm kiếm nhị phân luôn được sử dụng nếu 'n' là 1; tìm kiếm tuyến tính luôn luôn
được sử dụng nếu 'n' là 0. Trong chế độ không phải daemon, tìm kiếm nhị phân được sử dụng nếu 'n' là 1; nếu không thì
tìm kiếm tuyến tính được sử dụng. Giá trị mặc định của 'n' là 4. Tùy chọn này hoạt động với POP3
chỉ

-e | --bôi
(Từ khóa: expunge)
Sắp xếp để thực hiện xóa cuối cùng sau một số lượng tin nhắn nhất định. Dưới
POP2 hoặc POP3, thư tìm nạp không thể thực hiện xóa cuối cùng mà không gửi QUIT và kết thúc
phiên - khi bật tùy chọn này, tìm nạp thư sẽ phá vỡ truy xuất thư dài
phiên thành nhiều phiên phụ, gửi QUIT sau mỗi phiên phụ. Đây là một
bảo vệ tốt chống lại sự cố rớt dòng trên máy chủ POP3. Trong IMAP, nhận thư Thông thường
đưa ra lệnh EXPUNGE sau mỗi lần xóa để buộc xóa
thực hiện ngay lập tức. Điều này là an toàn nhất khi kết nối của bạn với máy chủ không ổn định và
đắt tiền, vì nó tránh gửi lại thư trùng lặp sau khi một dòng được nhấn. Tuy nhiên, trên
hộp thư lớn, chi phí lập chỉ mục lại sau mỗi thư có thể làm hỏng máy chủ
khá khó, vì vậy nếu kết nối của bạn đáng tin cậy, tốt hơn là bạn nên xóa bớt
thường xuyên. Cũng lưu ý rằng một số máy chủ thực thi độ trễ vài giây sau
từng thoát, do đó, fetchmail có thể không vào lại được ngay sau khi bị xóa
- bạn có thể thấy lỗi "khóa máy bận" nếu điều này xảy ra. Nếu bạn chỉ định tùy chọn này cho một
số nguyên N, nó cho biết nhận thư để chỉ xóa vấn đề sau mỗi lần xóa thứ N. Một
đối số XNUMX ngăn chặn hoàn toàn xóa bỏ hoàn toàn (vì vậy sẽ không xóa bỏ hoàn toàn
cho đến khi kết thúc cuộc chạy). Tùy chọn này không hoạt động với ETRN hoặc ODMR.

Xác thực Các lựa chọn
-u | --người sử dụng | --tên tài khoản
(Từ khóa: người dùng [tên])
Chỉ định nhận dạng người dùng sẽ được sử dụng khi đăng nhập vào máy chủ thư.
Nhận dạng người dùng thích hợp là cả máy chủ và người dùng phụ thuộc. Mặc định
là tên đăng nhập của bạn trên máy khách đang chạy nhận thư. Xem USER
XÁC NHẬN bên dưới để có mô tả đầy đủ.

-I | --giao diện
(Từ khóa: giao diện)
Yêu cầu thiết bị giao diện cụ thể phải được thiết lập và có cục bộ hoặc điều khiển từ xa cụ thể
Địa chỉ (hoặc dải ô) IPv4 (IPv6 chưa được hỗ trợ bởi tùy chọn này) trước khi bỏ phiếu.
Thường xuyên nhận thư được sử dụng qua liên kết TCP / IP điểm-điểm tạm thời
được thiết lập trực tiếp đến máy chủ thư thông qua SLIP hoặc PPP. Đó là một tương đối an toàn
kênh. Nhưng khi các tuyến TCP / IP khác đến máy chủ thư tồn tại (ví dụ: khi liên kết
được kết nối với ISP thay thế), tên người dùng và mật khẩu của bạn có thể dễ bị tấn công
rình mò (đặc biệt là khi chế độ daemon tự động thăm dò thư, gửi một
xóa mật khẩu qua mạng trong những khoảng thời gian có thể dự đoán được). Tùy chọn --interface có thể
được sử dụng để ngăn chặn điều này. Khi liên kết được chỉ định không lên hoặc không được kết nối với
một địa chỉ IP phù hợp, việc thăm dò ý kiến ​​sẽ bị bỏ qua. Định dạng là:

giao diện / iii.iii.iii.iii [/mmm.mmm.mmm.mmm]

Trường trước dấu gạch chéo đầu tiên là tên giao diện (nghĩa là sl0, ppp0, v.v.). Các
trường trước dấu gạch chéo thứ hai là địa chỉ IP được chấp nhận. Các lĩnh vực sau
dấu gạch chéo thứ hai là một mặt nạ chỉ định một dải địa chỉ IP để chấp nhận. Nếu không
mặt nạ hiện tại 255.255.255.255 được giả định (tức là một kết quả khớp chính xác). Tùy chọn này là
hiện chỉ được hỗ trợ trong Linux và FreeBSD. Xin vui lòng xem màn hình phần
cho bên dưới để biết thông tin cụ thể về FreeBSD.

Lưu ý rằng tùy chọn này có thể bị xóa khỏi phiên bản thư điện tử tìm nạp trong tương lai.

-M | --màn hình
(Từ khóa: màn hình)
Chế độ Daemon có thể gây ra các liên kết tạm thời tự động bị gỡ xuống sau khi
thời gian không hoạt động (ví dụ: liên kết PPP) để duy trì vô thời hạn. Tùy chọn này
xác định giao diện TCP / IP của hệ thống được giám sát hoạt động. Sau mỗi cuộc thăm dò
khoảng thời gian, nếu liên kết được thiết lập nhưng không có hoạt động nào khác xảy ra trên liên kết, thì
cuộc thăm dò sẽ bị bỏ qua. Tuy nhiên, khi fetchmail được đánh thức bởi một tín hiệu,
kiểm tra giám sát bị bỏ qua và cuộc thăm dò được tiến hành vô điều kiện. Tùy chọn này là
hiện chỉ được hỗ trợ trong Linux và FreeBSD. Cho màn hình và giao diện
các tùy chọn hoạt động cho người dùng không phải root trong FreeBSD, nhị phân thư tìm nạp phải là
đã cài đặt SGID kmem. Đây sẽ là một lỗ hổng bảo mật, nhưng thư điện tử tìm nạp chạy với
GID hiệu dụng được đặt thành của nhóm kmem có thể khi dữ liệu giao diện đang được
đã thu thập.

Lưu ý rằng tùy chọn này có thể bị xóa khỏi phiên bản thư điện tử tìm nạp trong tương lai.

--xác thực
(Từ khóa: auth [enticate])
Tùy chọn này cho phép bạn chỉ định một loại xác thực (xem XÁC THỰC CỦA NGƯỜI DÙNG
dưới đây để biết chi tiết). Các giá trị có thể là bất kì, mật khẩu, kerberos_v5, Kerberos
(hoặc, để có độ chính xác cao, kerberos_v4), gssapi, cram-md5, otp, ntlm, msn
(chỉ dành cho POP3), ngoài (chỉ IMAP) và ssh. Khi nào bất kì (mặc định) là
đã chỉ định, tìm nạp sẽ thử các phương pháp đầu tiên không yêu cầu mật khẩu (BÊN NGOÀI,
GSSAPI, KERBEROS IV, KERBEROS 5); thì nó sẽ tìm kiếm các phương pháp che mật khẩu của bạn
(CRAM-MD5, NTLM, X-OTP - lưu ý rằng MSN chỉ được hỗ trợ cho POP3, nhưng không
autoprobed); và chỉ khi máy chủ không hỗ trợ bất kỳ cái nào trong số đó thì nó mới gửi cho bạn
mật khẩu en clair. Các giá trị khác có thể được sử dụng để buộc các xác thực khác nhau
phương pháp (ssh ngăn chặn xác thực và do đó hữu ích cho IMAP PREAUTH).
(ngoài ngăn chặn xác thực và do đó hữu ích cho IMAP BÊN NGOÀI). Không tí nào
giá trị khác hơn mật khẩu, cram-md5, ntlm, msn or otp ngăn chặn bình thường của fetchmail
yêu cầu mật khẩu. Chỉ định ssh khi bạn đang sử dụng bảo mật end-to-end
kết nối chẳng hạn như một đường hầm ssh; xác định ngoài khi bạn sử dụng TLS với ứng dụng khách
xác thực và chỉ định gssapi or kerberos_v4 nếu bạn đang sử dụng một giao thức
biến thể sử dụng GSSAPI hoặc K4. Chọn giao thức KPOP sẽ tự động chọn
Xác thực Kerberos. Tùy chọn này không hoạt động với ETRN. Dịch vụ GSSAPI
tên phù hợp với đăng ký RFC-2743 và IANA, xem Bảo mật chung
Giao diện chương trình ứng dụng dịch vụ (GSSAPI) / Kerberos / Xác thực đơn giản và
Tên dịch vụ của lớp bảo mật (SASL) ⟨http://www.iana.org/assignments/
gssapi-service-names /⟩.

hỗn hợp Các lựa chọn
-f | --fetchmailrc
Chỉ định một tên không phải mặc định cho ~ / .fetchmailrc chạy tệp điều khiển. Tên đường dẫn
đối số phải là "-" (một dấu gạch ngang, nghĩa là đọc cấu hình từ
đầu vào chuẩn) hoặc tên tệp. Trừ khi tùy chọn --version cũng được bật, một
đối số tệp phải có quyền không quá 0700 (u = rwx, g =, o =) hoặc nếu không
/ dev / null.

-i | --idfile
(Từ khóa: idfile)
Chỉ định tên thay thế cho tệp .fetchids được sử dụng để lưu UID thông báo. GHI CHÚ:
kể từ khi fetchmail 6.3.0, quyền ghi vào thư mục chứa idfile là
bắt buộc, vì fetchmail ghi một tệp tạm thời và đổi tên nó vào vị trí của
idfile thực chỉ khi tệp tạm thời đã được ghi thành công. Điều này tránh
việc cắt bớt các tập tin id khi hết dung lượng đĩa.

--pidfile
(Từ khóa: pidfile; kể từ fetchmail v6.3.4)
Ghi đè vị trí mặc định của tệp PID. Mặc định: xem "MÔI TRƯỜNG" bên dưới.

-n | --norewrite
(Từ khóa: không viết lại)
Thông thường, nhận thư chỉnh sửa các tiêu đề địa chỉ RFC-822 (Tới, Từ, Cc, Bcc và Trả lời đến)
trong thư đã tìm nạp để mọi ID thư cục bộ tới máy chủ đều được mở rộng thành đầy đủ
địa chỉ (@ và tên máy chủ của máy chủ thư được thêm vào). Điều này cho phép trả lời trên
khách hàng để được giải quyết chính xác (nếu không người gửi thư của bạn có thể nghĩ rằng họ
nên được gửi tới người dùng cục bộ trên máy khách!). Tùy chọn này vô hiệu hóa
viết lại. (Tùy chọn này được cung cấp để xoa dịu những người hoang tưởng về
có MTA chỉnh sửa tiêu đề thư và muốn biết họ có thể ngăn chặn điều đó, nhưng
nói chung không phải là một ý kiến ​​hay nếu thực sự tắt tính năng viết lại.) Khi sử dụng ETRN hoặc ODMR,
tùy chọn viết lại không hiệu quả.

-E | --phong bì
(Từ khóa: phong bì; chỉ Multidrop)
Trong tệp cấu hình, cú pháp nâng cao được sử dụng:
phong bì [ ]

Tùy chọn này thay đổi tiêu đề nhận thư giả định sẽ mang theo một bản sao của thư
địa chỉ phong bì. Thông thường đây là 'X-Envelope-To'. Các tiêu đề thường thấy khác
để mang thông tin phong bì là 'X-Original-To' và 'Delivered-To'. Bây giờ, kể từ
những tiêu đề này không được tiêu chuẩn hóa, thực hành khác nhau. Xem cuộc thảo luận của
xử lý địa chỉ multidrop bên dưới. Là một trường hợp đặc biệt, 'phong bì "Đã nhận"' cho phép
phân tích cú pháp các dòng đã nhận theo kiểu sendmail. Đây là mặc định, nhưng không khuyến khích
bởi vì nó không hoàn toàn đáng tin cậy.

Lưu ý rằng thư tìm nạp yêu cầu dòng đã nhận ở một định dạng cụ thể: Nó phải
chứa "bởi chủ nhà cho địa chỉ", ở đâu chủ nhà phải khớp với một trong các tên máy chủ thư
mà fetchmail nhận dạng cho tài khoản được đề cập.

Đối số đếm tùy chọn (chỉ có sẵn trong tệp cấu hình) xác định
có bao nhiêu dòng tiêu đề loại này bị bỏ qua. Số lượng 1 có nghĩa là: bỏ qua số đầu tiên,
lấy thứ hai. Đếm 2 có nghĩa là: bỏ qua thứ nhất và thứ hai, lấy thứ ba, và
Sớm.

-Q | --qvirtual
(Từ khóa: qvirtual; Chỉ Multidrop)
Tiền tố chuỗi được chỉ định cho tùy chọn này sẽ bị xóa khỏi tên người dùng được tìm thấy
trong tiêu đề được chỉ định với phong bì Lựa chọn (trước làm tên multidrop
ánh xạ hoặc kiểm tra tên miền cục bộ, nếu có). Tùy chọn này hữu ích nếu
bạn đang sử dụng nhận thư để thu thập thư cho toàn bộ miền và ISP của bạn (hoặc
nhà cung cấp chuyển hướng thư của bạn) đang sử dụng qmail. Một trong những tính năng cơ bản của qmail
là Đã gửi đến: tiêu đề thư. Bất cứ khi nào qmail gửi một tin nhắn đến một địa phương
hộp thư nó đặt tên người dùng và tên máy chủ của người nhận phong bì trên dòng này.
Lý do chính cho điều này là để ngăn chặn các vòng lặp thư. Để thiết lập qmail thành hàng loạt thư
đối với một trang bị ngắt kết nối, ISP-mailhost thường sẽ đặt trang đó vào
Tệp điều khiển 'Virtualhosts' để nó sẽ thêm tiền tố vào tất cả các địa chỉ thư cho việc này
Địa điểm. Điều này dẫn đến thư được gửi đến '[email được bảo vệ]' có một
Đã gửi đến: dòng của biểu mẫu:

Đã gửi đến: [email được bảo vệ]

ISP có thể đặt tiền tố 'mbox-userstr-' bất kỳ thứ gì họ chọn ngoại trừ một chuỗi khớp với
tên máy chủ người dùng có thể. Bằng cách sử dụng tùy chọn 'phong bì Đã gửi đến:' bạn có thể thực hiện
fetchmail xác định một cách đáng tin cậy người nhận trên phong bì ban đầu, nhưng bạn phải loại bỏ
tiền tố 'mbox-userstr-' để phân phối đến đúng người dùng. Đây là những gì tùy chọn này dành cho.

--configdump
Phân tích cú pháp ~ / .fetchmailrc tệp, diễn giải bất kỳ tùy chọn dòng lệnh nào được chỉ định và
kết xuất báo cáo cấu hình ra đầu ra tiêu chuẩn. Báo cáo cấu hình là một dữ liệu
gán cấu trúc trong ngôn ngữ Python. Tùy chọn này được sử dụng với
một tương tác ~ / .fetchmailrc biên tập viên thích nạpmailconf, được viết bằng Python.

Đã loại bỏ Các lựa chọn
-T | --netsec
Đã bị xóa trước phiên bản 6.3.0, thư viện inet6_apps cơ bản bắt buộc đã được
đã ngừng sản xuất và không còn nữa.

USER THẨM QUYỀN VÀ MÔI TRƯỜNG

Tất cả các chế độ ngoại trừ ETRN đều yêu cầu xác thực máy khách đối với máy chủ. Người dùng bình thường
xác thực trong nhận thư rất giống cơ chế xác thực của ftp(1). Các
id người dùng và mật khẩu chính xác phụ thuộc vào hệ thống bảo mật cơ bản tại máy chủ thư.

Nếu máy chủ thư là một máy Unix mà bạn có tài khoản người dùng thông thường,
tên đăng nhập thông thường và mật khẩu được sử dụng với nhận thư. Nếu bạn sử dụng cùng một tên đăng nhập
trên cả máy chủ và máy khách, bạn không cần phải lo lắng về việc chỉ định id người dùng
với -u tùy chọn - hành vi mặc định là sử dụng tên đăng nhập của bạn trên máy khách
làm id người dùng trên máy chủ. Nếu bạn sử dụng tên đăng nhập khác trên máy chủ
máy, chỉ định tên đăng nhập đó với -u Lựa chọn. ví dụ: nếu tên đăng nhập của bạn là 'jsmith'
trên một máy có tên 'mailgrunt', bạn sẽ bắt đầu nhận thư như sau:

tìm nạp thư -u jsmith mailgrunt

Hành vi mặc định của nhận thư là để nhắc bạn nhập mật khẩu máy chủ thư của bạn trước khi
kết nối được thiết lập. Đây là cách an toàn nhất để sử dụng nhận thư và đảm bảo rằng
mật khẩu sẽ không bị xâm phạm. Bạn cũng có thể chỉ định mật khẩu của mình trong
~ / .fetchmailrc tập tin. Điều này thuận tiện khi sử dụng nhận thư trong chế độ daemon hoặc với
tập lệnh.

Sử dụng mạng các tập tin
Nếu bạn không chỉ định mật khẩu, và nhận thư không thể trích xuất một từ của bạn
~ / .fetchmailrc tệp, nó sẽ tìm kiếm một ~ / .netrc tập tin trong thư mục chính của bạn trước đây
yêu cầu một cách tương tác; nếu một mục nhập khớp với máy chủ thư được tìm thấy trong tệp đó,
mật khẩu sẽ được sử dụng. Trước tiên, Fetchmail tìm kiếm sự trùng khớp về tên cuộc thăm dò; nếu nó tìm thấy
không, nó kiểm tra sự trùng khớp về tên. Xem ftp(1) trang người đàn ông để biết chi tiết về
cú pháp của ~ / .netrc tập tin. Để hiển thị một ví dụ thực tế, một .netrc có thể trông giống như sau:

máy hermes.example.org
đăng nhập joe
mật khẩu hàng đầu

Bạn có thể lặp lại khối này với thông tin người dùng khác nhau nếu bạn cần cung cấp nhiều hơn
một mật khẩu.

Tính năng này có thể cho phép bạn tránh trùng lặp thông tin mật khẩu trong nhiều hơn một
tập tin.

Trên máy chủ thư không cung cấp tài khoản người dùng thông thường, id người dùng và mật khẩu của bạn là
thường được chỉ định bởi quản trị viên máy chủ khi bạn đăng ký một hộp thư trên máy chủ.
Liên hệ với quản trị viên máy chủ của bạn nếu bạn không biết id người dùng và mật khẩu chính xác cho
tài khoản hộp thư của bạn.

POP3 BIẾN

Các phiên bản đầu tiên của POP3 (RFC1081, RFC1225) hỗ trợ một dạng thô độc lập
xác thực bằng cách sử dụng .rhost tệp ở phía máy chủ thư. Trong biến thể RPOP này,
ID cho mỗi người dùng cố định tương đương với một mật khẩu đã được gửi rõ ràng qua một liên kết đến một
cổng, bằng lệnh RPOP chứ không phải PASS để cảnh báo máy chủ rằng nó sẽ thực hiện đặc biệt
kiểm tra. RPOP được hỗ trợ bởi nhận thư (bạn có thể chỉ định 'giao thức RPOP' để có
chương trình gửi 'RPOP' thay vì 'PASS') nhưng việc sử dụng chương trình này rất không được khuyến khích và hỗ trợ
sẽ bị xóa khỏi phiên bản thư điện tử tìm nạp trong tương lai. Cơ sở này dễ bị giả mạo
và đã được rút trong RFC1460.

RFC1460 đã giới thiệu xác thực APOP. Trong biến thể này của POP3, bạn đăng ký một APOP
mật khẩu trên máy chủ lưu trữ máy chủ của bạn (trên một số máy chủ, chương trình thực hiện việc này được gọi là
Popauth(số 8)). Bạn đặt cùng một mật khẩu trong ~ / .fetchmailrc tập tin. Mỗi lần nhận thư
đăng nhập, nó sẽ gửi một mã băm MD5 của mật khẩu của bạn và thời gian chào máy chủ đến máy chủ,
có thể xác minh nó bằng cách kiểm tra cơ sở dữ liệu ủy quyền của nó.

Lưu ý việc này nhạc pop is Không còn xem xét kháng chống lại người đàn ông đứng giữa các cuộc tấn công.

TRẢ LẠI or TOP
nhận thư thực hiện một số nỗ lực để làm cho máy chủ tin rằng các thư đã không được truy xuất,
bằng cách sử dụng lệnh TOP với một số lượng lớn các dòng khi có thể. TOP là một lệnh
truy xuất tiêu đề đầy đủ và nhận thư-số lượng xác định của các dòng cơ thể. Nó là
tùy chọn và do đó không được triển khai bởi tất cả các máy chủ và một số được biết là triển khai nó
không đúng cách. Tuy nhiên, trên nhiều máy chủ, lệnh RETR lấy toàn bộ thông báo
với tiêu đề và nội dung, đặt cờ "đã thấy" (ví dụ: trong giao diện web), trong khi
Lệnh TOP không làm điều đó.

nhận thư sẽ luôn sử dụng lệnh RETR nếu "tìm nạp" được đặt. nhận thư cũng sẽ sử dụng
lệnh RETR nếu "keep" được đặt và "uidl" chưa được đặt. Cuối cùng, nhận thư sẽ sử dụng
Lệnh RETR trên máy chủ Maillennium POP3 / PROXY (được sử dụng bởi Comcast) để tránh việc cố tình lên TOP
hiểu sai trong máy chủ này gây ra hỏng thư.

Trong tất cả các trường hợp khác, nhận thư sẽ sử dụng lệnh TOP. Điều này ngụ ý rằng trong "keep"
thiết lập, "uidl" phải được đặt nếu muốn "TOP".

Lưu ý rằng mô tả này đúng với phiên bản hiện tại của thư điện tử, nhưng hành vi
có thể thay đổi trong các phiên bản trong tương lai. Đặc biệt, fetchmail có thể thích lệnh RETR hơn
bởi vì lệnh TOP gây ra nhiều phiền toái trên một số máy chủ và chỉ là tùy chọn.

ALTERNATE THẨM QUYỀN CÁC HÌNH THỨC

Nếu là của bạn nhận thư được xây dựng với sự hỗ trợ của Kerberos và bạn chỉ định xác thực Kerberos
(với --auth hoặc .fetchmailrc tùy chọn xác nhận kerberos_v4) nó sẽ cố gắng
nhận vé Kerberos từ máy chủ thư khi bắt đầu mỗi truy vấn. Lưu ý: nếu một trong hai
tên thăm dò hoặc thông qua tên là 'hesiod', fetchmail sẽ cố gắng sử dụng Hesiod để tra cứu
máy chủ thư.

Nếu bạn sử dụng POP3 hoặc IMAP với xác thực GSSAPI, nhận thư sẽ mong đợi máy chủ
có khả năng GSSAPI phù hợp RFC1731- hoặc RFC1734 và sẽ sử dụng nó. Hiện tại cái này
mới chỉ được thử nghiệm qua Kerberos V, vì vậy bạn dự kiến ​​sẽ có quyền cấp vé
vé. Bạn có thể chuyển tên người dùng khác với tên chính của mình bằng cách sử dụng tiêu chuẩn
--người sử dụng lệnh hoặc bởi .fetchmailrc tùy chọn người sử dụng.

Nếu daemon IMAP của bạn trả về phản hồi PREAUTH trong dòng chào mừng của nó, fetchmail sẽ
chú ý điều này và bỏ qua bước xác thực thông thường. Điều này có thể hữu ích, ví dụ: nếu bạn
bắt đầu imapd một cách rõ ràng bằng ssh. Trong trường hợp này, bạn có thể khai báo giá trị xác thực
'ssh' trên mục nhập trang web đó để dừng lại .nhận thư khỏi yêu cầu bạn nhập mật khẩu khi nó bắt đầu
lên.

Nếu bạn sử dụng xác thực ứng dụng khách với TLS1 và daemon IMAP của bạn trả về AUTH = BÊN NGOÀI
phản hồi, fetchmail sẽ nhận thấy điều này và sẽ sử dụng phím tắt xác thực và sẽ không
gửi cụm mật khẩu. Trong trường hợp này, bạn có thể khai báo giá trị xác thực 'bên ngoài'
trên trang web đó để dừng lại nhận thư khỏi yêu cầu bạn nhập mật khẩu khi nó khởi động.

Nếu bạn đang sử dụng POP3 và máy chủ đưa ra thử thách mật khẩu một lần phù hợp với
RFC1938, nhận thư sẽ sử dụng mật khẩu của bạn như một cụm từ mật khẩu để tạo ra
phản ứng. Điều này tránh gửi các bí mật qua mạng không được mã hóa.

Xác thực RPA của Compuserve được hỗ trợ. Nếu bạn biên dịch trong phần hỗ trợ, nhận thư
sẽ cố gắng thực hiện xác thực cụm từ mật khẩu RPA thay vì gửi qua mật khẩu
vi phạm nếu nó phát hiện thấy "@ compuserve.com" trong tên máy chủ.

Nếu bạn đang sử dụng IMAP, xác thực NTLM của Microsoft (được sử dụng bởi Microsoft Exchange) là
được hỗ trợ. Nếu bạn biên dịch trong phần hỗ trợ, nhận thư sẽ cố gắng thực hiện một NTLM
xác thực (thay vì gửi qua mật khẩu) bất cứ khi nào máy chủ trả về
AUTH = NTLM trong phản ứng khả năng của nó. Chỉ định một giá trị tùy chọn người dùng trông giống như
'user @ domain': phần bên trái của @ sẽ được chuyển làm tên người dùng và phần
ở bên phải là miền NTLM.

Bảo mật Ổ cắm Layers (SSL) và Giao thông lớp Bảo mật (TLS)
vận chuyển. Ngoài ra, kiểm tra lại POP3 và IMAP cũng có thể thương lượng SSL / TLS bằng cách
STARTTLS (hoặc STLS).

Lưu ý rằng fetchmail hiện đang sử dụng thư viện OpenSSL, thư viện này được cung cấp đầy đủ tài liệu,
vì vậy các lỗi có thể xảy ra chỉ vì các lập trình viên không nhận thức được yêu cầu của OpenSSL
trong ngày. Ví dụ: kể từ v6.3.16, fetchmail gọi OpenSSL_add_all_algorithm (),
cần thiết để hỗ trợ các chứng chỉ sử dụng SHA256 trên OpenSSL 0.9.8 - cái này
thông tin được ẩn sâu trong tài liệu và hoàn toàn không rõ ràng. Xin đừng
do dự khi báo cáo các lỗi SSL tinh vi.

Bạn có thể truy cập các dịch vụ được mã hóa SSL bằng cách chỉ định các tùy chọn bắt đầu bằng --ssl, chẳng hạn như
dưới dạng --ssl, --sslproto, --sslcertck và những người khác. Bạn cũng có thể làm điều này bằng cách sử dụng
tùy chọn người dùng tương ứng trong tệp .fetchmailrc. Một số dịch vụ, chẳng hạn như POP3 và
IMAP, có các cổng nổi tiếng khác nhau được xác định cho các dịch vụ được mã hóa SSL. Các
các cổng được mã hóa sẽ tự động được chọn khi bật SSL và không có cổng rõ ràng nào
được chỉ định. Ngoài ra, dòng lệnh --sslcertck hoặc tùy chọn tệp điều khiển chạy sslcertck
nên được sử dụng để buộc kiểm tra chứng chỉ nghiêm ngặt - xem bên dưới.

Nếu SSL không được định cấu hình, thư tìm nạp thường sẽ cố gắng sử dụng STARTTLS một cách cơ hội.
STARTTLS có thể được thực thi bằng cách sử dụng tự động --sslproto và bị đánh bại bằng cách sử dụng --sslproto ''.
Kết nối TLS sử dụng cùng một cổng với phiên bản không mã hóa của giao thức và thương lượng
TLS thông qua lệnh đặc biệt. Dòng lệnh --sslcertck hoặc tùy chọn tệp điều khiển chạy sslcertck
nên được sử dụng để buộc kiểm tra chứng chỉ nghiêm ngặt - xem bên dưới.

--sslcertck is khuyến nghị: Khi kết nối với máy chủ được mã hóa SSL hoặc TLS, máy chủ
trình chứng chỉ cho khách hàng để xác nhận. Chứng chỉ được kiểm tra để xác minh
rằng tên chung trong chứng chỉ khớp với tên của máy chủ được liên hệ và
rằng ngày có hiệu lực và ngày hết hạn trong chứng chỉ cho thấy rằng chứng chỉ hiện đang
có giá trị. Nếu bất kỳ lần kiểm tra nào trong số này không thành công, một thông báo cảnh báo sẽ được in, nhưng kết nối
tiếp tục. Chứng chỉ máy chủ không cần phải được ký bởi bất kỳ Chứng nhận cụ thể nào
Thẩm quyền và có thể là chứng chỉ "tự ký". Nếu tùy chọn dòng lệnh --sslcertck
hoặc tùy chọn tệp điều khiển chạy sslcertck được sử dụng, thư tìm nạp thay vào đó sẽ hủy bỏ nếu có bất kỳ điều nào trong số này
kiểm tra không thành công, bởi vì nó phải giả định rằng có một cuộc tấn công man-in-the-middle trong việc này
, do đó thư tìm nạp không được để lộ mật khẩu văn bản rõ ràng. Sử dụng sslcertck hoặc
Tùy chọn --sslcertck do đó được khuyên dùng.

Một số máy chủ được mã hóa SSL có thể yêu cầu chứng chỉ phía máy khách. Công khai phía khách hàng
Chứng chỉ SSL và khóa SSL riêng có thể được chỉ định. Nếu được yêu cầu bởi máy chủ,
chứng chỉ máy khách được gửi đến máy chủ để xác thực. Một số máy chủ có thể yêu cầu giá trị hợp lệ
chứng chỉ ứng dụng khách và có thể từ chối kết nối nếu chứng chỉ không được cung cấp hoặc nếu
chứng chỉ không hợp lệ. Một số máy chủ có thể yêu cầu các chứng chỉ phía máy khách được ký bởi
một Cơ quan Chứng nhận được công nhận. Định dạng cho các tệp khóa và tệp chứng chỉ
là yêu cầu của các thư viện SSL bên dưới (OpenSSL trong trường hợp chung).

Lưu ý về việc sử dụng SSL: Mặc dù đã đề cập ở trên thiết lập với máy chủ tự ký
các chứng chỉ được truy xuất qua dây có thể bảo vệ bạn khỏi kẻ nghe trộm thụ động, nó
không giúp chống lại kẻ tấn công đang hoạt động. Đó rõ ràng là một sự cải tiến so với việc gửi
mật khẩu rõ ràng, nhưng bạn nên biết rằng một cuộc tấn công man-in-the-middle là rất nhỏ
có thể (đặc biệt với các công cụ như dsniff ⟨http://monkey.org/~dugsong/dsniff/⟩,).
Sử dụng kiểm tra chứng chỉ nghiêm ngặt với cơ quan cấp chứng chỉ được máy chủ công nhận và
ứng dụng khách, hoặc có thể của một đường hầm SSH (xem một số ví dụ bên dưới) sẽ thích hợp hơn nếu bạn
quan tâm nghiêm túc đến tính bảo mật của hộp thư và mật khẩu của bạn.

ESMTP THÁNG TÁM
nhận thư cũng hỗ trợ xác thực đến máy chủ ESMTP ở phía máy khách theo
RFC 2554. Bạn có thể chỉ định một cặp tên / mật khẩu được sử dụng với các từ khóa 'esmtpname'
và 'esmtppassword'; trước đây mặc định là tên người dùng của người dùng đang gọi.

DAEMON PHƯƠNG THỨC

Giới thiệu các daemon chế độ
Trong chế độ daemon, nhận thư tự đặt nó vào nền và chạy mãi mãi, truy vấn từng
máy chủ được chỉ định và sau đó ngủ trong một khoảng thời gian bỏ phiếu nhất định.

Bắt đầu các daemon chế độ
Có một số cách để làm cho thư tìm nạp hoạt động ở chế độ daemon. Trên dòng lệnh,
--daemon or -d tùy chọn chạy nhận thư trong chế độ daemon. Bạn phải
chỉ định đối số số là khoảng thời gian bỏ phiếu (thời gian chờ sau khi hoàn thành
toàn bộ chu kỳ thăm dò với máy chủ cuối cùng và trước khi bắt đầu chu kỳ thăm dò tiếp theo với
máy chủ đầu tiên) trong vài giây.

Ví dụ: chỉ cần gọi

tìm nạp thư -d 900

do đó, sẽ thăm dò ý kiến ​​của tất cả các máy chủ được mô tả trong ~ / .fetchmailrc tập tin (ngoại trừ những
bị loại trừ rõ ràng bằng động từ 'bỏ qua') ít thường xuyên hơn một lần sau mỗi 15 phút
(chính xác: 15 phút + thời gian mà cuộc bình chọn diễn ra).

Cũng có thể đặt khoảng thời gian bỏ phiếu trong ~ / .fetchmailrc nộp hồ sơ bằng cách nói
'set daemon ', ở đâu là một số nguyên giây. Nếu bạn làm
điều này, fetchmail sẽ luôn bắt đầu ở chế độ daemon trừ khi bạn ghi đè nó bằng lệnh-
tùy chọn dòng --daemon 0 hoặc -d0.

Mỗi người dùng chỉ được phép sử dụng một quy trình daemon; trong chế độ daemon, nhận thư thiết lập một mỗi-
người dùng lockfile để đảm bảo điều này. (Tuy nhiên, bạn có thể gian lận và đặt FETCHMAILHOME
biến môi trường để vượt qua cài đặt này, nhưng trong trường hợp đó, bạn có trách nhiệm
để đảm bảo rằng bạn không bỏ phiếu trên cùng một máy chủ với hai quy trình cùng một lúc.)

Awakening các lý lịch daemon
Thông thường, việc gọi fetchmail với một daemon trong nền sẽ gửi một tín hiệu đánh thức đến
daemon và thoát mà không có đầu ra. Daemon nền sau đó bắt đầu chu kỳ thăm dò tiếp theo của nó
ngay lập tức. Tín hiệu đánh thức, SIGUSR1, cũng có thể được gửi theo cách thủ công. Hành động đánh thức
cũng xóa mọi cờ 'nêm' cho biết rằng các kết nối đã bị chêm do không thành công
xác thực hoặc nhiều thời gian chờ.

Chấm dứt các lý lịch daemon
Tùy chọn --từ bỏ sẽ giết một tiến trình daemon đang chạy thay vì đánh thức nó (nếu có
Không có quá trình như vậy, nhận thư sẽ thông báo cho bạn). Nếu tùy chọn --quit xuất hiện cuối cùng trên
dòng lệnh, nhận thư sẽ giết tiến trình daemon đang chạy và sau đó thoát. Nếu không thì,
nhận thư trước tiên sẽ giết một tiến trình daemon đang chạy và sau đó tiếp tục chạy với
sự lựa chọn khác.

Hữu ích lựa chọn cho daemon chế độ
-L or --logfile tùy chọn (từ khóa: set logfile) chỉ có hiệu quả
khi fetchmail được tách ra và ở chế độ daemon. Lưu ý rằng các tệp nhật ký phải tồn tại trước
fetchmail được chạy, bạn có thể sử dụng chạm(1) lệnh với tên tệp làm đối số duy nhất của nó
để tạo ra nó.
Tùy chọn này cho phép bạn chuyển hướng các thông báo trạng thái vào một tệp nhật ký cụ thể (làm theo
tùy chọn với tên tệp log). Tệp nhật ký được mở để phụ thêm, vì vậy các thông báo trước đó
không bị xóa. Điều này chủ yếu hữu ích cho việc gỡ lỗi cấu hình. Lưu ý rằng
fetchmail không phát hiện xem tệp nhật ký có được xoay hay không, tệp nhật ký chỉ được mở một lần khi
fetchmail bắt đầu. Bạn cần khởi động lại fetchmail sau khi xoay logfile và trước đó
nén nó (nếu có).

--syslog tùy chọn (từ khóa: set syslog) cho phép bạn chuyển hướng trạng thái và thông báo lỗi
phát ra cho syslog(3) daemon hệ thống nếu có. Tin nhắn được ghi với id là
nhận thư, cơ sở LOG_MAILvà các ưu tiên LOG_ERR, LOG_ALERT or LOG_INFO. Điều này
tùy chọn dành cho trạng thái ghi nhật ký và thông báo lỗi cho biết trạng thái của
daemon và các kết quả trong khi tìm nạp thư từ (các) máy chủ. Thông báo lỗi cho lệnh
tùy chọn dòng và phân tích cú pháp .fetchmailrc tệp vẫn được ghi vào stderr, hoặc
tệp nhật ký được chỉ định. Các --nosyslog tùy chọn tắt sử dụng syslog(3), giả sử đó là
bật trong ~ / .fetchmailrc tập tin. Tùy chọn này bị ghi đè, trong một số trường hợp,
by --logfile (mà xem).

-N or --nodetach tùy chọn ngăn chặn nền và tách quá trình daemon
từ thiết bị đầu cuối điều khiển của nó. Điều này hữu ích cho việc gỡ lỗi hoặc khi tìm nạp thư chạy như
con của một quá trình giám sát chẳng hạn như trong đó(8) hoặc Gerrit Pape's runit(số 8). Lưu ý rằng điều này
cũng khiến tùy chọn logfile bị bỏ qua.

Lưu ý rằng trong khi chạy ở chế độ daemon thăm dò máy chủ POP2 hoặc IMAP2bis, lỗi tạm thời
(chẳng hạn như lỗi DNS hoặc từ chối gửi thư gửi) có thể buộc tùy chọn tìm nạp được bật cho
khoảng thời gian của chu kỳ bỏ phiếu tiếp theo. Đây là một tính năng mạnh mẽ. Nó có nghĩa là nếu một
thư được tìm nạp (và do đó được đánh dấu bởi máy chủ thư) nhưng không được gửi cục bộ do
đối với một số lỗi tạm thời, nó sẽ được tìm nạp lại trong chu kỳ thăm dò tiếp theo. (IMAP
logic không xóa các tin nhắn cho đến khi chúng được gửi, vì vậy vấn đề này không phát sinh.)

Nếu bạn chạm vào hoặc thay đổi ~ / .fetchmailrc tệp trong khi tìm nạp thư đang chạy ở chế độ daemon,
điều này sẽ được phát hiện vào đầu chu kỳ thăm dò tiếp theo. Khi một thay đổi
~ / .fetchmailrc được phát hiện, fetchmail đọc lại nó và khởi động lại từ đầu (sử dụng giám đốc điều hành(2);
không có thông tin trạng thái nào được giữ lại trong phiên bản mới). Lưu ý rằng nếu tìm nạp thư cần phải
truy vấn mật khẩu, nếu bạn phá vỡ ~ / .fetchmailrc cú pháp của tệp, mới
phiên bản sẽ biến mất một cách nhẹ nhàng và âm thầm khi khởi động.

HÀNH CHÍNH LỰA CHỌN

- hiệu trưởng tùy chọn (từ khóa: set postmaster) chỉ định phương sách cuối cùng
tên người dùng mà thư multidrop sẽ được chuyển tiếp đến nếu không thể có người nhận cục bộ phù hợp
tìm. Nó cũng được sử dụng làm điểm đến của thư không gửi được nếu 'thư trả lại' toàn cầu
tùy chọn tắt và bổ sung cho thư bị chặn spam nếu tùy chọn chung 'thư trả lại' là
tắt và tùy chọn toàn cầu 'spambounce' đang bật. Tùy chọn này mặc định cho người dùng đã gọi
nhận thư. Nếu người dùng đang gọi là người chủ, thì mặc định của tùy chọn này là người dùng
'người quản lý bưu điện'. Đặt quản trị viên bưu điện thành chuỗi trống sẽ gây ra thư như được mô tả ở trên
bị loại bỏ - tuy nhiên, điều này thường là một ý tưởng tồi. Xem thêm mô tả của
Biến môi trường 'FETCHMAILUSER' trong phần MÔI TRƯỜNG bên dưới.

--nobounce hoạt động giống như tùy chọn chung "đặt không có thư trả lại", sẽ thấy.

--vô hình tùy chọn (từ khóa: đặt ẩn) cố gắng ẩn thư tìm nạp.
Thông thường, thư tìm nạp hoạt động giống như bất kỳ MTA nào khác - nó tạo tiêu đề Đã nhận
vào mỗi thông báo mô tả vị trí của nó trong chuỗi truyền và cho MTA biết
chuyển tiếp tới đó là thư đến từ chính máy tìm nạp thư đang chạy. Nếu
tùy chọn ẩn được bật, tiêu đề Đã nhận bị chặn và thư tìm nạp cố gắng giả mạo
MTA mà nó chuyển tiếp để nghĩ rằng nó đến trực tiếp từ máy chủ gửi thư.

--showdots tùy chọn (từ khóa: set showdots) buộc fetchmail hiển thị các chấm tiến trình đồng đều
nếu đầu ra chuyển đến một tệp hoặc thư tìm nạp không ở chế độ tiết. Fetchmail hiển thị
dấu chấm theo mặc định khi chạy ở chế độ --verbose và đầu ra chuyển đến bảng điều khiển. Tùy chọn này là
bị bỏ qua trong chế độ --silent.

Bằng cách chỉ định --tracepolls tùy chọn, bạn có thể yêu cầu tìm nạp thư để thêm thông tin vào
Tiêu đề đã nhận trên biểu mẫu "polling {label} account {user}", trong đó {label} là tài khoản
nhãn (từ rcfile được chỉ định, bình thường ~ / .fetchmailrc) và {user} là tên người dùng
được sử dụng để đăng nhập vào máy chủ thư. Tiêu đề này có thể được sử dụng để lọc
email không có thông tin tiêu đề hữu ích và bạn muốn có thư từ
các tài khoản được sắp xếp vào các hộp thư khác nhau (ví dụ: điều này có thể xảy ra nếu bạn có
tài khoản trên cùng một máy chủ đang chạy một danh sách gửi thư và được đăng ký vào danh sách bằng cách sử dụng
tài khoản đó). Mặc định là không thêm bất kỳ tiêu đề nào như vậy. Trong .fetchmailrc, cái này được gọi là
'dấu vết'.

QUAY LẠI THẤT ​​BẠI CHẾ ĐỘ

Các giao thức nhận thư sử dụng để nói chuyện với người gửi thư bên cạnh khả năng chống đạn. Bình thường
chuyển tiếp hoạt động đến cổng 25, không có tin nhắn nào bị xóa (hoặc thậm chí được đánh dấu để xóa)
trên máy chủ lưu trữ cho đến khi trình nghe SMTP ở phía máy khách đã xác nhận nhận thư việc này
thư đã được chấp nhận để gửi hoặc bị từ chối do khối thư rác.

Tuy nhiên, khi chuyển tiếp đến MDA, có nhiều khả năng xảy ra lỗi hơn. Một số MDA là
'an toàn' và trả về trạng thái nonzero một cách đáng tin cậy đối với bất kỳ lỗi giao hàng nào, ngay cả một lỗi do
giới hạn tài nguyên tạm thời. Các thư thả(1) chương trình là như thế này; hầu hết các chương trình cũng vậy
được thiết kế như các đại lý vận chuyển thư, chẳng hạn như gửi thư(1), bao gồm trình bao bọc thư của
Postfix và thi(1). Các chương trình này mang lại sự thừa nhận tích cực đáng tin cậy và có thể
được sử dụng với tùy chọn mda mà không có nguy cơ mất thư. Tuy nhiên, MDA không an toàn có thể trả về 0
ngay cả khi giao hàng thất bại. Nếu điều này xảy ra, bạn sẽ mất thư.

Chế độ bình thường của nhận thư là cố gắng chỉ tải xuống các tin nhắn 'mới', để nguyên
(và chưa xóa) thư bạn đã đọc trực tiếp trên máy chủ (hoặc được tải xuống bằng
trước nhận thư --giữ cho). Nhưng bạn có thể thấy rằng các tin nhắn bạn đã đọc trên
máy chủ đang được tìm nạp (và bị xóa) ngay cả khi bạn không chỉ định - tất cả. Có
một số lý do điều này có thể xảy ra.

Một có thể là bạn đang sử dụng POP2. Giao thức POP2 không bao gồm
trạng thái 'mới' hoặc 'cũ' trong tin nhắn, vì vậy nhận thư phải coi tất cả các tin nhắn là mới tất cả
thời gian. Nhưng POP2 đã lỗi thời nên điều này khó xảy ra.

Sự cố POP3 tiềm ẩn có thể là máy chủ chèn thư vào giữa hộp thư
(một số triển khai VMS của thư được đồn đại để làm điều này). Các nhận thư mã giả định
rằng các thư mới được nối vào cuối hộp thư; khi điều này không đúng, nó có thể
coi một số tin nhắn cũ là mới và ngược lại. Sử dụng UIDL trong khi cài đặt fastuidl 0 có thể
sửa lỗi này, nếu không, hãy xem xét chuyển sang IMAP.

Tuy nhiên, một vấn đề khác của POP3 là nếu họ không thể tạo các tệp mẫu trong nhà của người dùng
thư mục, một số máy chủ POP3 sẽ gửi lại phản hồi không có tài liệu gây ra thư tìm nạp
để báo cáo "Không có thư".

Mã IMAP sử dụng sự hiện diện hay vắng mặt của cờ máy chủ \ Đã thấy để quyết định xem hoặc
không phải là một tin nhắn mới. Đây không phải là điều đúng đắn phải làm, tìm nạp thư nên kiểm tra
UIDVALIDITY và sử dụng UID, nhưng nó chưa làm được điều đó. Trong Unix, nó dựa trên IMAP của bạn
máy chủ để nhận thấy cờ Trạng thái kiểu BSD được đặt bởi tác nhân người dùng thư và đặt cờ \ Seen
từ chúng khi thích hợp. Tất cả các máy chủ Unix IMAP mà chúng tôi biết đều làm được điều này, mặc dù nó không
được chỉ định bởi IMAP RFCs. Nếu bạn từng truy cập vào một máy chủ không có, triệu chứng sẽ
là các thư bạn đã đọc trên máy chủ của bạn sẽ trông mới đối với máy chủ. Trong này
trường hợp (không chắc), chỉ những thư bạn đã tìm nạp nhận thư --giữ cho cả hai sẽ không bị xóa
và đánh dấu cũ.

Trong các chế độ ETRN và ODMR, nhận thư không thực sự truy xuất tin nhắn; thay vào đó, nó hỏi
trình nghe SMTP của máy chủ để bắt đầu chuyển hàng đợi tới máy khách thông qua SMTP. Do đó nó
chỉ gửi những tin nhắn chưa được gửi.

SPAM LỌC

Nhiều trình nghe SMTP cho phép quản trị viên thiết lập 'bộ lọc thư rác' để chặn
email từ các miền cụ thể. Dòng MAIL FROM hoặc DATA kích hoạt tính năng này sẽ
gợi ra một phản hồi SMTP (không may là) thay đổi tùy theo người nghe.

Các phiên bản mới hơn của gửi thư trả về mã lỗi là 571.

Theo RFC2821, điều chính xác để trả lại trong tình huống này là 550 "Đã yêu cầu
hành động không được thực hiện: hộp thư không khả dụng "(bản nháp thêm" [Ví dụ: không tìm thấy hộp thư, không
quyền truy cập hoặc lệnh bị từ chối vì lý do chính sách]. ").

Các phiên bản cũ hơn của thi MTA trả về 501 "Lỗi cú pháp trong tham số hoặc đối số".

postfix MTA chạy 554 như một phản hồi chống thư rác.

Zmailer có thể từ chối mã có phản hồi 500 (theo sau là mã trạng thái nâng cao
chứa nhiều thông tin hơn).

Trả lại mã nhận thư coi như phản hồi chống thư rác và hủy thư có thể được
đặt với tùy chọn 'chống thư rác'. Đây là một trong những có thể ba hoàn cảnh dưới đó
fetchmail từng loại bỏ thư (các lỗi khác là lỗi 552 và 553 được mô tả bên dưới và
việc ngăn chặn các thông báo nhiều tin nhắn có ID tin nhắn đã được thấy).

If nhận thư đang tìm nạp từ máy chủ IMAP, phản hồi chống thư rác sẽ được phát hiện và
thông báo bị từ chối ngay lập tức sau khi các tiêu đề đã được tìm nạp mà không cần đọc
nội dung tin nhắn. Do đó, bạn sẽ không phải trả tiền cho việc tải xuống nội dung thư rác.

Theo mặc định, danh sách phản hồi chống thư rác trống.

Nếu thư rác tùy chọn chung được bật, thư bị chặn spam sẽ kích hoạt
Thư bị trả lại RFC1892 / RFC1894 thông báo cho người khởi tạo rằng chúng tôi không chấp nhận thư từ
nó. Xem thêm BUGS.

SMTP / ESMTP ERROR XỬ LÝ

Bên cạnh tính năng chặn thư rác được mô tả ở trên, thư tìm nạp thực hiện các hành động đặc biệt - có thể là
được sửa đổi bởi tùy chọn --softbounce - trên các mã phản hồi lỗi SMTP / ESMTP sau

452 (không đủ bộ nhớ hệ thống)
Để lại thư trong hộp thư máy chủ để truy xuất sau này.

552 (tin nhắn vượt quá kích thước tin nhắn tối đa cố định)
Xóa tin nhắn khỏi máy chủ. Gửi thư trả lại cho người khởi tạo.

553 (miền gửi không hợp lệ)
Xóa tin nhắn khỏi máy chủ. Thậm chí đừng cố gửi thư trả lại tới
người khởi xướng.

Các lỗi khác lớn hơn hoặc bằng 500 kích hoạt thư bị trả lại cho người khởi tạo, trừ khi
bị đàn áp bởi --softbounce. Xem thêm BUGS.

CÁC CHẠY KIỂM SOÁT FILE

Cách ưa thích để thiết lập thư tìm nạp là viết một .fetchmailrc nộp hồ sơ tại nhà của bạn
thư mục (bạn có thể thực hiện việc này trực tiếp, bằng trình soạn thảo văn bản hoặc gián tiếp qua nạpmailconf).
Khi có xung đột giữa các đối số dòng lệnh và các đối số trong
tệp, các đối số dòng lệnh được ưu tiên.

Để bảo vệ tính bảo mật cho mật khẩu của bạn, ~ / .fetchmailrc bình thường có thể không có nhiều hơn
hơn 0700 (u = rwx, g =, o =) quyền; nhận thư sẽ khiếu nại và thoát ra nếu không (điều này
kiểm tra bị chặn khi --version được bật).

Bạn có thể đọc .fetchmailrc tệp dưới dạng danh sách các lệnh sẽ được thực thi khi nhận thư is
được gọi mà không có đối số.

chạy Kiểm soát cú pháp
Nhận xét bắt đầu bằng dấu '#' và kéo dài đến cuối dòng. Nếu không thì tệp
bao gồm một loạt các mục nhập máy chủ hoặc các câu lệnh tùy chọn chung ở định dạng tự do,
cú pháp hướng mã thông báo.

Có bốn loại mã thông báo: từ khóa ngữ pháp, số (tức là chuỗi chữ số thập phân),
chuỗi không được trích dẫn và chuỗi được trích dẫn. Một chuỗi được trích dẫn được giới hạn bởi dấu ngoặc kép và có thể
chứa khoảng trắng (và các chữ số được trích dẫn được coi như một chuỗi). Lưu ý rằng các chuỗi được trích dẫn
cũng sẽ chứa các ký tự nguồn cấp dữ liệu dòng nếu chúng chạy trên hai hoặc nhiều dòng, trừ khi bạn
sử dụng dấu gạch chéo ngược để nối các dòng (xem bên dưới). Một chuỗi không được trích dẫn là bất kỳ phân tách bằng khoảng trắng nào
mã thông báo không phải là số, chuỗi được trích dẫn hoặc chứa các ký tự đặc biệt ',', ';',
':', hoặc '='.

Bất kỳ khoảng trắng nào sẽ phân tách các mã thông báo trong các mục nhập của máy chủ, nhưng nếu không sẽ bị bỏ qua. Bạn
có thể sử dụng chuỗi thoát dấu gạch chéo ngược (\ n cho LF, \ t cho HT, \ b cho BS, \ r cho CR, \nnn cho
thập phân (trong đó nnn không thể bắt đầu bằng 0), \ 0ooo cho hệ bát phân và \ xhh cho hex) để nhúng
ký tự không in được hoặc dấu phân cách chuỗi trong chuỗi. Trong các chuỗi được trích dẫn, một dấu gạch chéo ngược
ở cuối dòng sẽ tự gây ra dấu gạch chéo ngược và nguồn cấp dữ liệu dòng (LF hoặc NL, mới
dòng) ký tự được bỏ qua, để bạn có thể quấn các chuỗi dài. Không có dấu gạch chéo ngược ở
cuối dòng, ký tự nguồn cấp dữ liệu dòng sẽ trở thành một phần của chuỗi.

Cảnh báo: trong khi chúng giống với trình tự thoát kiểu C, chúng không giống nhau. nhận thư
chỉ hỗ trợ tám kiểu này. C hỗ trợ nhiều chuỗi thoát hơn bao gồm
dấu gạch chéo ngược (\) và một ký tự, nhưng không hỗ trợ mã thập phân và không
yêu cầu số 0 đứng đầu trong ký hiệu bát phân. Ví dụ: fetchmail diễn giải \ 233 giống như
\ xE9 (chữ e nhỏ trong tiếng Latinh có dấu sắc), trong đó C sẽ diễn giải \ 233 là số bát phân 0233 = \ x9B
(CSI, trình giới thiệu trình tự điều khiển).

Mỗi mục nhập máy chủ bao gồm một trong các từ khóa 'thăm dò ý kiến' hoặc 'bỏ qua', theo sau là một máy chủ
tên, theo sau là tùy chọn máy chủ, theo sau là bất kỳ số lượng người dùng (hoặc tên người dùng) nào
mô tả, theo sau là tùy chọn người dùng. Lưu ý: nguyên nhân phổ biến nhất của lỗi cú pháp là
trộn lẫn các tùy chọn người dùng và máy chủ hoặc đặt các tùy chọn người dùng trước phần mô tả người dùng.

Đối với khả năng tương thích ngược, từ 'máy chủ' là từ đồng nghĩa với 'thăm dò ý kiến'.

Bạn có thể sử dụng các từ khóa nhiễu 'và', 'với', 'có', 'muốn' và 'tùy chọn' ở bất kỳ đâu trong
mục nhập để làm cho nó giống với tiếng Anh. Chúng bị bỏ qua, nhưng có thể làm cho các mục nhập dễ dàng hơn nhiều
để đọc trong nháy mắt. Các ký tự dấu câu ':', ';' và ',' cũng bị bỏ qua.

Poll vs. Bỏ qua
Động từ 'thăm dò' yêu cầu fetchmail truy vấn máy chủ này khi nó được chạy mà không có đối số. Các
động từ 'bỏ qua' cho biết nhận thư không thăm dò ý kiến ​​của máy chủ này trừ khi nó được đặt tên rõ ràng trên
dòng lệnh. (Động từ 'bỏ qua' cho phép bạn thử nghiệm với các mục kiểm tra một cách an toàn, hoặc
dễ dàng vô hiệu hóa các mục nhập cho các máy chủ tạm thời ngừng hoạt động.)

Từ khóa / Tùy chọn Tổng kết
Dưới đây là các tùy chọn pháp lý. Các hậu tố từ khóa được đặt trong dấu ngoặc vuông là tùy chọn.
Những thứ tương ứng với các tùy chọn dòng lệnh ngắn được theo sau bởi '-' và
thư tùy chọn. Nếu tùy chọn chỉ liên quan đến một chế độ hoạt động, nó được lưu ý là
's' hoặc 'm' cho chế độ đơn giọt hoặc đa giọt, tương ứng.

Dưới đây là các tùy chọn toàn cầu hợp pháp:

Chức năng Chế độ Chọn từ khoá
... ───────────────────
đặt daemon -d Đặt khoảng thời gian thăm dò nền trong
giây.
đặt quản trị viên bưu điện Cung cấp tên của phương sách cuối cùng
người nhận thư (mặc định: người dùng
đang chạy fetchmail, "postmaster" nếu
do người dùng root điều hành)
đặt thư lỗi trực tiếp bouncemail tới người gửi
(Default)
đặt không có thư trả lại Thư báo lỗi trực tiếp đến cục bộ
giám đốc bưu điện (theo
tùy chọn toàn cầu 'postmaster' ở trên).
đặt không gửi thư rác Không trả lại thư bị chặn thư rác
(mặc định).
đặt spambounce Thư bị chặn trả lại thư bị chặn spam
(theo người dùng 'chống thư rác'
tùy chọn) trở lại đích với tư cách là
được chỉ ra bởi 'thư trả lại'
tùy chọn toàn cầu. Cảnh báo: Không
sử dụng điều này để trả lại thư rác cho
người gửi - hầu hết thư rác được gửi đi
với địa chỉ người gửi sai và do đó
lựa chọn này làm tổn thương người vô tội
người ngoài cuộc.
đặt không có softbounce Xóa vĩnh viễn không gửi được
thư. Nó được khuyến khích sử dụng
tùy chọn này nếu cấu hình
đã được kiểm tra kỹ lưỡng.
đặt softbounce Giữ vĩnh viễn không gửi được
thư như thể là một lỗi tạm thời
đã xảy ra (mặc định).
đặt logfile -L Tên của tệp để nối lỗi và
thông báo trạng thái tới. Chỉ một
hiệu quả trong chế độ daemon và nếu
gỡ bỏ fetchmail. Nếu hiệu quả,
ghi đè định syslog.
đặt idfile -i Tên của tệp để lưu trữ UID
danh sách trong.
đặt nhật ký hệ thống Do lỗi đăng nhập
syslog(3). Có thể bị ghi đè bởi định
tệp nhật ký.

đặt không có nhật ký hệ thống Tắt đăng nhập lỗi
syslog(3). (vỡ nợ)
đặt thuộc tính Giá trị chuỗi bị bỏ qua bởi
fetchmail (có thể được sử dụng bởi
tập lệnh mở rộng).

Dưới đây là các tùy chọn máy chủ hợp pháp:

Chức năng Chế độ Chọn từ khoá
... ────────────────
thông qua Chỉ định tên DNS của máy chủ thư,
ghi đè tên cuộc thăm dò
proto [col] -p Chỉ định giao thức (trường hợp
không nhạy cảm): POP2, POP3, IMAP,
APOP, KPOP
local [domains] m Chỉ định (các) miền được coi là
như địa phương
cổng Chỉ định cổng dịch vụ TCP / IP
(lỗi thời, hãy sử dụng 'dịch vụ' thay thế).
dịch vụ -P Chỉ định tên dịch vụ (một số
giá trị cũng được cho phép và
được coi là số cổng TCP / IP).
auth [enticate] Đặt loại xác thực (mặc định
'không tí nào')
timeout -t Thời gian chờ máy chủ không hoạt động trong
giây (mặc định 300)
phong bì -E m Chỉ định tiêu đề địa chỉ phong bì
tên
không có phong bì m Tắt tính năng tìm kiếm phong bì
địa chỉ
tiền tố tên miền ảo qvirtual -Q m Qmail tới
xóa khỏi tên người dùng
aka m Chỉ định tên DNS thay thế của
người gửi thư
giao diện -Tôi chỉ định (các) giao diện IP phải
sẵn sàng để máy chủ thăm dò ý kiến
nơi
giám sát -M Chỉ định địa chỉ IP để giám sát
hoạt động
plugin Chỉ định lệnh thông qua đó
tạo kết nối máy chủ.
plugout Chỉ định lệnh qua đó để
tạo kết nối người nghe.
dns m Bật tra cứu DNS cho nhiều phông nền
(Default)
no dns m Tắt tra cứu DNS cho nhiều phông nền
checkalias m Thực hiện so sánh theo địa chỉ IP cho
nhiều giọt
không có checkalias m Làm so sánh theo tên cho
multidrop (mặc định)
uidl -U Buộc POP3 sử dụng phía máy khách
UIDL (khuyến nghị)
không có uidl Tắt sử dụng POP3 phía máy khách
UIDL (mặc định)
Khoảng thời gian Chỉ kiểm tra trang web này sau mỗi N cuộc thăm dò
các chu kỳ; N là một đối số dạng số.
dấu vết Thêm thông tin theo dõi cuộc thăm dò vào
tiêu đề Đã nhận
chính Đặt hiệu trưởng của Kerberos (chỉ
hữu ích với IMAP và kerberos)
esmtpname Đặt tên cho RFC2554
xác thực cho ESMTP
máy chủ.
esmtppassword Đặt mật khẩu cho RFC2554
xác thực cho ESMTP
máy chủ.

bad-header Cách xử lý thư có nội dung xấu
đầu trang. Có thể bị từ chối (mặc định) hoặc
Chấp nhận.

Dưới đây là các mô tả và tùy chọn của người dùng hợp pháp:

Chức năng Chế độ Chọn từ khoá
... ──────────────────
người dùng [tên] -u Đây là mô tả người dùng và
phải đến trước sau máy chủ
mô tả và sau khi có thể
tùy chọn máy chủ và trước người dùng
tùy chọn.
Nó đặt tên người dùng từ xa nếu bằng
chính nó hoặc được theo sau bởi 'there', hoặc
tên người dùng cục bộ nếu được theo sau bởi
'ở đây'.
là Kết nối người dùng cục bộ và từ xa
tên
để Kết nối người dùng cục bộ và từ xa
tên
pass [word] Chỉ định mật khẩu tài khoản từ xa
ssl Kết nối với máy chủ qua
giao thức cơ sở được chỉ định sử dụng SSL
mã hóa
sslcert Chỉ định tệp cho khách hàng bên
chứng chỉ SSL công cộng
sslcertfile Chỉ định tệp với CA đáng tin cậy
Giấy chứng nhận
sslcertpath Chỉ định thư mục c_rehash-ed với
chứng chỉ CA đáng tin cậy.
sslkey Chỉ định tệp cho khách hàng bên
khóa SSL riêng tư
sslproto Buộc giao thức ssl cho kết nối
thư mục -r Chỉ định thư mục từ xa để truy vấn
smtphost -S Chỉ định (các) máy chủ smtp để chuyển tiếp tới
tìm nạp tên miền m Chỉ định tên miền cho thư nào
nên được tìm nạp
smtpaddress -D Chỉ định miền sẽ được đưa vào
RCPT TO dòng
smtpname Chỉ định người dùng và miền là
đưa vào dòng RCPT TO
chống thư rác -Z Chỉ định trả về SMTP là gì
được hiểu là khối chính sách thư rác
mda -m Chỉ định MDA để phân phối tại địa phương
bsmtp -o Chỉ định tệp loạt BSMTP để nối thêm
đến
preconnect Lệnh được thực thi trước mỗi
liên quan
postconnect Lệnh sẽ được thực thi sau mỗi
liên quan
keep -k Không xóa các tin nhắn đã xem từ
máy chủ (đối với POP3, uidl là
đề nghị)
flush -F Xóa tất cả các thư đã thấy trước đó
truy vấn (NGUY HIỂM)
limitflush Xóa tất cả các thư quá khổ
trước khi truy vấn
fetchall -a Tìm nạp tất cả các tin nhắn cho dù đã xem hay
không
viết lại Viết lại địa chỉ đích cho
trả lời (mặc định)
dảicr Dải xuống dòng từ đầu đến cuối
dòng
forcecr Buộc xuống dòng trả về ở cuối
dòng

pass8bits Buộc BODY = 8BITMIME sang ESMTP
người nghe
dropstatus Strip Status và X-Mozilla-Status
dòng thư đến
dropdelivered Dải phân phối Các dòng được phân phối đến ngoài
thư đến
mimedecode Chuyển đổi trích dẫn-có thể in thành 8-bit
trong MIME tin nhắn
nhàn rỗi nhàn rỗi chờ tin nhắn mới
sau mỗi cuộc thăm dò (chỉ IMAP)
không giữ -K Xóa tin nhắn đã thấy khỏi máy chủ
(Default)
không tuôn ra Không xóa tất cả các tin nhắn đã xem
trước khi truy vấn (mặc định)
không tìm nạp Chỉ lấy tin nhắn mới
(Default)
không viết lại Không viết lại tiêu đề
không dải cr Không dải xuống dòng
(Default)
no forcecr Đừng ép xuống dòng lúc
EOL (mặc định)
không pass8bits Không buộc BODY = 8BITMIME thành ESMTP
người nghe (mặc định)
không thả trạng thái Không thả tiêu đề trạng thái
(Default)
không dropdelivered không drop những tiêu đề đã được gửi đến
(Default)
không có mã mimedec Không chuyển đổi có thể in được trích dẫn thành
8-bit trong tin nhắn MIME (mặc định)
không nhàn rỗi Không chờ đợi cái mới
tin nhắn sau mỗi cuộc thăm dò (IMAP
chỉ)
giới hạn -l Đặt giới hạn kích thước thư
cảnh báo -w Đặt khoảng thời gian cảnh báo kích thước tin nhắn
batchlimit -b Tối đa # tin nhắn để chuyển tiếp
kết nối duy nhất
tìm nạp -B Tối đa # tin nhắn để tìm nạp trong một lần
kết nối
tìm nạp # kích thước thư tối đa để tìm nạp
giao dịch đơn lẻ
fastuidl Sử dụng tìm kiếm nhị phân cho lần đầu tiên chưa thấy
tin nhắn (chỉ POP3)
expunge -e Thực hiện xóa vào mỗi thứ #
tin nhắn (chỉ IMAP và POP3)
thuộc tính Giá trị chuỗi bị bỏ qua bởi
fetchmail (có thể được sử dụng bởi
tập lệnh mở rộng)

Tất cả các tùy chọn người dùng phải bắt đầu bằng mô tả người dùng (tùy chọn người dùng hoặc tên người dùng) và theo
tất cả các mô tả và tùy chọn máy chủ.

Trong tệp .fetchmailrc, đối số chuỗi 'phong bì' có thể được đặt trước bởi một khoảng trắng-
số tách biệt. Con số này, nếu được chỉ định, là số lượng các tiêu đề như vậy cần bỏ qua
(nghĩa là, đối số 1 chọn tiêu đề thứ hai của kiểu đã cho). Đây là đôi khi
hữu ích để bỏ qua các tiêu đề phong bì không có thật được tạo bởi đại lý phân phối địa phương của ISP hoặc
chuyển tiếp nội bộ (ví dụ: thông qua hệ thống kiểm tra thư).

Từ khóa Không Tương ứng Đến Tùy chọn Thiết bị chuyển mạch
Các tùy chọn 'thư mục' và 'smtphost' (không giống như các tùy chọn tương đương dòng lệnh của chúng) có thể có
danh sách các tên được phân tách bằng dấu cách hoặc dấu phẩy theo sau chúng.

Tất cả các tùy chọn tương ứng với các đối số dòng lệnh rõ ràng, ngoại trừ những điều sau: 'qua',
'khoảng thời gian', 'hay còn gọi là', 'là', 'đến', 'dns' / 'không có dns', 'checkalias' / 'không có checkalias', 'mật khẩu',
'preconnect', 'postconnect', 'localdomains', 'stripcr' / 'no stripcr', 'forcecr' / 'no
forcecr ',' pass8bits '/' no pass8bits '' dropstatus / no dropstatus ',' dropdelivered / no
dropdelivered ',' mimedecode / no mimedecode ',' no nhàn rỗi 'và' no phong bì '.

Tùy chọn 'qua' dành cho nếu bạn muốn có nhiều hơn một cấu hình trỏ vào
cùng một trang web. Nếu nó xuất hiện, đối số chuỗi sẽ được coi là tên DNS thực của
máy chủ gửi thư để truy vấn. Điều này sẽ ghi đè đối số của cuộc thăm dò, sau đó có thể
chỉ đơn giản là một nhãn riêng biệt cho cấu hình (ví dụ: những gì bạn sẽ cung cấp trên lệnh
dòng để truy vấn rõ ràng máy chủ này).

Tùy chọn 'khoảng thời gian' (sử dụng đối số số) cho phép bạn ít thăm dò ý kiến ​​của máy chủ hơn
thường xuyên hơn khoảng thời gian thăm dò cơ bản. Nếu bạn nói 'khoảng N', máy chủ sẽ chọn tùy chọn này
được đính kèm với sẽ chỉ được truy vấn mỗi N khoảng thời gian thăm dò.

Thả đơn vs. Nhiều giọt lựa chọn
Hãy đảm bảo rằng bạn đã đọc phần có tiêu đề CÁC SỬ DỤNG VÀ LẠM DỤNG OF ĐA NĂNG HỘP THƯ nếu bạn
dự định sử dụng chế độ nhiều giọt.

Từ khóa 'là' hoặc 'đến' liên kết (các) tên (máy khách) cục bộ (hoặc tên máy chủ) sau đây
đến các ánh xạ tên máy khách được phân tách bằng =) với tên người dùng máy chủ thư trong mục nhập. Nếu một
is / to list có '*' là họ của nó, các tên không nhận dạng được chỉ cần chuyển qua. Ghi chú
điều đó cho đến khi nhận thư phiên bản 6.3.4 bao gồm, các danh sách này chỉ có thể chứa các bộ phận cục bộ
tên người dùng (fetchmail sẽ chỉ xem xét phần trước dấu @). nhận thư
phiên bản 6.3.5 và mới hơn hỗ trợ các địa chỉ đầy đủ ở phía bên trái của các ánh xạ này,
và chúng được ưu tiên hơn bất kỳ ánh xạ 'localdomains', 'aka', 'via' hoặc tương tự nào.

Một tên địa phương duy nhất có thể được sử dụng để hỗ trợ chuyển hướng thư của bạn khi tên người dùng của bạn trên
máy khách khác với tên của bạn trên máy chủ thư. Khi chỉ có một
tên địa phương, thư được chuyển tiếp đến tên người dùng cục bộ đó bất kể thư đã Nhận,
Tiêu đề Tới, Cc và Bcc. Trong trường hợp này, nhận thư không bao giờ tra cứu DNS.

Khi có nhiều hơn một tên địa phương (hoặc ánh xạ tên), nhận thư nhìn vào phong bì
tiêu đề, nếu được định cấu hình, và nếu không thì tại các tiêu đề Đã nhận, Đến, Cc và Bcc của các tiêu đề đã truy xuất
thư (đây là 'chế độ đa phông nền'). Nó tìm kiếm các địa chỉ có phần tên máy chủ phù hợp
tên cuộc thăm dò của bạn hoặc các tùy chọn 'qua', 'hay còn gọi là' hoặc 'tên miền địa phương' của bạn và thường cũng dành cho
Các phần tên máy chủ mà DNS cho nó biết là bí danh của máy chủ thư. Xem cuộc thảo luận của
'dns', 'checkalias', 'localdomains' và 'aka' để biết chi tiết về cách các địa chỉ phù hợp
xử lý.

If nhận thư không thể khớp với bất kỳ tên người dùng hoặc địa chỉ miền cục bộ nào của máy chủ thư, thư sẽ
bị trả lại. Thông thường, nó sẽ được gửi đến người gửi, nhưng nếu 'thư trả lại' toàn cầu
tùy chọn bị tắt, thay vào đó, thư sẽ được chuyển đến người quản lý bưu điện địa phương. (xem 'người quản lý bưu điện'
tùy chọn toàn cầu). Xem thêm BUGS.

Tùy chọn 'dns' (thường bật) kiểm soát cách địa chỉ từ các hộp thư nhiều ngăn
đã kiểm tra. Bật, nó cho phép logic để kiểm tra từng địa chỉ máy chủ không khớp với 'aka' hoặc
khai báo 'localdomains' bằng cách tra cứu nó với DNS. Khi tên người dùng máy chủ thư là
được công nhận đính kèm với một phần tên máy chủ phù hợp, ánh xạ cục bộ của nó được thêm vào danh sách
người nhận tại địa phương.

Tùy chọn 'checkalias' (thường tắt) mở rộng các tra cứu được thực hiện bởi từ khóa 'dns'
ở chế độ đa phông nền, cung cấp cách đối phó với các MTA từ xa tự nhận dạng bằng cách sử dụng
tên chính tắc của họ, trong khi họ được thăm dò ý kiến ​​bằng bí danh. Khi một máy chủ như vậy được thăm dò ý kiến,
kiểm tra để trích xuất địa chỉ phong bì không thành công và nhận thư hoàn nguyên để giao hàng bằng cách sử dụng
Tiêu đề To / Cc / Bcc (Xem bên dưới 'Địa chỉ tiêu đề so với địa chỉ phong bì'). Chỉ định tùy chọn này
hướng dẫn nhận thư để truy xuất tất cả các địa chỉ IP được liên kết với cả tên cuộc thăm dò
và tên được sử dụng bởi MTA từ xa và để so sánh các địa chỉ IP. Cái này
rất hữu ích trong các trường hợp máy chủ từ xa có tên chuẩn thường xuyên
thay đổi, nếu không sẽ yêu cầu sửa đổi đối với rcfile. 'checkalias' không có
nếu 'không có dns' được chỉ định trong rcfile.

Tùy chọn 'aka' được sử dụng với các hộp thư nhiều phông. Nó cho phép bạn khai báo trước một danh sách
bí danh DNS cho máy chủ. Đây là một bản hack tối ưu hóa cho phép bạn giao dịch không gian
cho tốc độ. Khi nào nhận thư, trong khi xử lý một hộp thư nhiều phông nền, dò tìm thông qua tin nhắn
tiêu đề tìm kiếm tên của máy chủ thư, khai báo trước những cái thông thường có thể lưu nó từ
phải thực hiện tra cứu DNS. Lưu ý: các tên bạn cung cấp làm đối số cho 'aka' được so khớp như
hậu tố - nếu bạn chỉ định (giả sử) 'aka netaxs.com', điều này sẽ không chỉ khớp với tên máy chủ
netaxs.com, nhưng bất kỳ tên máy chủ nào kết thúc bằng '.netaxs.com'; chẳng hạn như (giả sử) pop3.netaxs.com
và mail.netaxs.com.

Tùy chọn 'tên miền cục bộ' cho phép bạn khai báo danh sách tên miền mà tìm nạp thư
xem xét địa phương. Khi thư tìm nạp đang phân tích cú pháp các dòng địa chỉ trong chế độ đa phông nền và
phân đoạn theo sau của tên máy chủ phù hợp với miền cục bộ đã khai báo, địa chỉ đó được chuyển
thông qua trình nghe hoặc MDA không bị thay đổi (ánh xạ tên cục bộ là không đã áp dụng).

Nếu bạn đang sử dụng 'tên miền cục bộ', bạn cũng có thể cần chỉ định 'không có phong bì',
vô hiệu hóa nhận thưnỗ lực bình thường để suy ra địa chỉ phong bì từ dòng Đã nhận
hoặc tiêu đề X-Envelope-To hoặc bất kỳ tiêu đề nào đã được đặt trước đó bởi 'phong bì'. nếu bạn
đặt 'không có phong bì' trong mục nhập mặc định, có thể hoàn tác điều đó trong các mục nhập riêng lẻ
bằng cách sử dụng 'phong bì '. Là một trường hợp đặc biệt, 'phong bì "Đã nhận"' khôi phục
phân tích cú pháp mặc định của các dòng Đã nhận.

mật khẩu tùy chọn yêu cầu một đối số chuỗi, là mật khẩu được sử dụng với
máy chủ của mục nhập.

Từ khóa 'preconnect' cho phép bạn chỉ định một lệnh shell sẽ được thực thi ngay trước đó
mỗi lần nhận thư thiết lập kết nối máy chủ thư. Điều này có thể hữu ích nếu bạn
cố gắng thiết lập các kết nối POP an toàn với sự hỗ trợ của ssh(1). Nếu lệnh
trả về trạng thái khác không, cuộc thăm dò ý kiến ​​của máy chủ thư đó sẽ bị hủy bỏ.

Tương tự, từ khóa 'postconnect' tương tự cho phép bạn chỉ định một lệnh shell là
được thực thi ngay sau mỗi lần kết nối máy chủ thư bị gỡ xuống.

Tùy chọn 'forcecr' kiểm soát xem các dòng chỉ kết thúc bằng LF có được cấp CRLF hay không
chấm dứt trước khi chuyển tiếp. Nói chính xác thì RFC821 yêu cầu điều này, nhưng ít MTA
thực thi yêu cầu nó để tùy chọn này thường tắt (chỉ một MTA như vậy, qmail, trong
sử dụng đáng kể tại thời điểm viết bài).

Tùy chọn 'stripcr' kiểm soát xem liệu các dấu xuống dòng có bị loại bỏ khỏi thư đã truy xuất hay không
trước khi nó được chuyển tiếp. Thông thường không cần thiết đặt điều này, vì nó mặc định là
'bật' (bật tước CR) khi có MDA được khai báo nhưng 'tắt' (tước CR
bị tắt) khi chuyển tiếp qua SMTP. Nếu cả 'stripcr' và 'forcecr' đều được bật, thì 'stripcr'
sẽ ghi đè.

Tùy chọn 'pass8bits' tồn tại để đối phó với các chương trình thư của Microsoft làm một cách ngu ngốc
"Nội dung-Chuyển-Mã hoá: 7bit" trên mọi thứ. Khi tắt tùy chọn này (mặc định) và
một tiêu đề như vậy hiện tại, nhận thư tuyên bố BODY = 7BIT cho một người nghe có khả năng ESMTP; cái này
gây ra sự cố cho các thư thực sự sử dụng bộ ký tự ISO 8 bit hoặc KOI-8, điều này sẽ
bị cắt xén bằng cách loại bỏ các bit cao của tất cả các ký tự. Nếu 'pass8bits' được bật,
nhận thư buộc phải khai báo BODY = 8BITMIME cho bất kỳ trình nghe nào có khả năng ESMTP. Nếu
trình nghe 8-bit-sạch (như tất cả các trình nghe chính hiện nay)
kết quả.

Tùy chọn 'dropstatus' kiểm soát xem dòng Trạng thái không và X-Mozilla-Trạng thái
được giữ lại trong thư đã tìm nạp (mặc định) hoặc bị loại bỏ. Giữ lại chúng cho phép MUA của bạn
xem những thư nào (nếu có) đã được đánh dấu là đã thấy trên máy chủ. Mặt khác, nó có thể
gây nhầm lẫn với một số trình thông báo thư mới, giả định rằng bất kỳ thứ gì có dòng Trạng thái trong đó đều có
đã được nhìn thấy. (Lưu ý: các dòng Trạng thái trống được chèn bởi một số máy chủ POP có lỗi là
bị loại bỏ vô điều kiện.)

Tùy chọn 'dropdelivered' kiểm soát việc các tiêu đề Đã gửi đến có được giữ lại trong chế độ tìm nạp hay không
thư (mặc định) hoặc bị loại bỏ. Các tiêu đề này được thêm bởi máy chủ thư Qmail và Postfix
để tránh vòng lặp thư nhưng có thể cản trở bạn nếu bạn cố gắng "nhân bản" một máy chủ thư
trong cùng một miền. Sử dụng cẩn thận.

Tùy chọn 'mimedecode' kiểm soát xem các thư MIME sử dụng mã hóa có thể in được trích dẫn hay không
được tự động chuyển đổi thành dữ liệu 8-bit thuần túy. Nếu bạn đang gửi thư tới ESMTP-
có khả năng, trình nghe 8-bit-sạch (bao gồm tất cả các MTA chính như sendmail), sau đó
điều này sẽ tự động chuyển đổi dữ liệu và tiêu đề thư có thể in được trích dẫn thành dữ liệu 8 bit,
giúp bạn dễ hiểu hơn khi đọc mail. Nếu chương trình e-mail của bạn biết cách đối phó
với tin nhắn MIME, thì tùy chọn này không cần thiết. Tùy chọn mimedecode bị tắt bởi
mặc định, vì thực hiện chuyển đổi RFC2047 trên tiêu đề sẽ loại bỏ thông tin về bộ ký tự
và có thể dẫn đến kết quả xấu nếu mã hóa phần đầu khác với mã hóa nội dung.

Tùy chọn 'nhàn rỗi' được thiết kế để sử dụng với các máy chủ IMAP hỗ trợ RFC2177 IDLE
mở rộng lệnh, nhưng không yêu cầu nghiêm ngặt. Nếu nó được bật và tìm nạp thư
phát hiện rằng IDLE được hỗ trợ, một IDLE sẽ được cấp vào cuối mỗi cuộc thăm dò. Điều này sẽ
yêu cầu máy chủ IMAP giữ kết nối mở và thông báo cho máy khách khi có thư mới
có sẵn. Nếu IDLE không được hỗ trợ, thư tìm nạp sẽ mô phỏng nó bằng cách phát hành định kỳ
KHÔNG RA ĐÂU. Nếu bạn cần thăm dò một liên kết thường xuyên, IDLE có thể tiết kiệm băng thông bằng cách loại bỏ TCP / IP
kết nối và trình tự LOGIN / LOGOUT. Mặt khác, một kết nối IDLE sẽ gần như ăn
tất cả thời gian tìm nạp thư của bạn, bởi vì nó sẽ không bao giờ ngắt kết nối và cho phép người khác
các cuộc thăm dò sẽ xảy ra trừ khi máy chủ hết thời gian chờ IDLE. Nó cũng không hoạt động với nhiều
thư mục; chỉ thư mục đầu tiên sẽ được thăm dò.

Tùy chọn 'thuộc tính' là một cơ chế mở rộng. Nó nhận một đối số chuỗi, là
bị bỏ qua bởi chính fetchmail. Đối số chuỗi có thể được sử dụng để lưu trữ cấu hình
thông tin cho các tập lệnh yêu cầu nó. Đặc biệt, đầu ra của '--configdump'
tùy chọn sẽ làm cho các thuộc tính được liên kết với mục nhập của người dùng có sẵn cho Python
kịch bản.

hỗn hợp chạy Kiểm soát Các lựa chọn
Các từ 'here' và 'there' có ý nghĩa hữu ích giống như tiếng Anh. Bình thường 'eric người dùng
là esr 'có nghĩa là thư cho người dùng từ xa' eric 'phải được gửi đến' esr ', nhưng
bạn có thể làm cho điều này rõ ràng hơn bằng cách nói 'user eric there is esr here' hoặc đảo ngược nó bằng cách nói
'user esr ở đây là eric ở đó'

Giá trị nhận dạng giao thức hợp pháp để sử dụng với từ khóa 'giao thức' là:

tự động (hoặc TỰ ĐỘNG) (kế thừa, sẽ bị xóa khỏi bản phát hành trong tương lai)
pop2 (hoặc POP2) (kế thừa, sẽ bị xóa khỏi bản phát hành trong tương lai)
pop3 (hoặc POP3)
sdps (hoặc SDPS)
imap (hoặc IMAP)
apop (hoặc APOP)
kpop (hoặc KPOP)

Các loại xác thực hợp pháp là 'bất kỳ', 'mật khẩu', 'kerberos', 'kerberos_v4', 'kerberos_v5'
và 'gssapi', 'cram-md5', 'otp', 'msn' (chỉ dành cho POP3), 'ntlm', 'ssh', 'external' (chỉ
IMAP). Loại 'mật khẩu' chỉ định xác thực bằng cách truyền mật khẩu thông thường
(mật khẩu có thể là văn bản thuần túy hoặc được mã hóa theo giao thức cụ thể như trong CRAM-
MD5); 'kerberos' nói với nhận thư để cố gắng nhận một vé Kerberos khi bắt đầu mỗi
thay vào đó, hãy truy vấn và gửi một chuỗi tùy ý làm mật khẩu; và 'gssapi' nói với fetchmail
để sử dụng xác thực GSSAPI. Xem mô tả của từ khóa 'auth' để biết thêm.

Chỉ định 'kpop' đặt giao thức POP3 qua cổng 1109 với xác thực Kerberos V4.
Các giá trị mặc định này có thể bị ghi đè bởi các tùy chọn sau này.

Có một số câu lệnh tùy chọn chung: 'set logfile' theo sau là một chuỗi đặt giống nhau
toàn cục được chỉ định bởi --logfile. Tùy chọn --logfile dòng lệnh sẽ ghi đè điều này. Ghi chú
rằng --logfile chỉ có hiệu quả nếu thư tìm nạp tự tách ra khỏi thiết bị đầu cuối và
logfile đã tồn tại trước khi chạy thư tìm nạp và nó sẽ ghi đè --syslog trong trường hợp này.
Ngoài ra, 'set daemon' đặt khoảng thời gian thăm dò như --daemon. Điều này có thể bị ghi đè bởi
tùy chọn dòng lệnh --daemon; đặc biệt --daemon 0 có thể được sử dụng để buộc tiền cảnh
hoạt động. Câu lệnh 'set postmaster' đặt địa chỉ mà mail multidrop tới
mặc định nếu không có kết quả phù hợp cục bộ. Cuối cùng, 'set syslog' sẽ gửi thông báo nhật ký đến
syslogd(8).

NỢ NHẬN THƯ

Nhận thư sự cố
Có nhiều cách khác nhau khiến thư tìm nạp có thể "sập", tức là dừng hoạt động đột ngột và
một cách bất ngờ. "Sự cố" thường đề cập đến tình trạng lỗi mà phần mềm không
tự xử lý. Một chế độ lỗi phổ biến là "lỗi phân đoạn" hoặc "tín hiệu 11" hoặc
"SIGSEGV" hay gọi tắt là "segfault". Những điều này có thể do phần cứng hoặc phần mềm gây ra
các vấn đề. Các giá trị mặc định do phần mềm tạo ra thường có thể được sao chép dễ dàng và giống nhau
nơi, trong khi các giá trị mặc định do phần cứng gây ra có thể biến mất nếu máy tính được khởi động lại, hoặc
tắt nguồn trong vài giờ và có thể xảy ra ở các vị trí ngẫu nhiên ngay cả khi bạn sử dụng
phần mềm theo cùng một cách.

Để giải quyết các lỗi mặc định do phần cứng gây ra, hãy tìm thành phần bị lỗi và sửa chữa hoặc thay thế
nó. Câu hỏi thường gặp về Sig11 ⟨http://www.bitwizard.nl/sig11/⟩ Có thể giúp bạn về chi tiết.

Để giải quyết các giá trị mặc định do phần mềm gây ra, các nhà phát triển có thể cần một "dấu vết ngăn xếp".

Cho phép nhận thư cốt lõi bãi rác
Theo mặc định, fetchmail ngăn chặn các kết xuất lõi vì chúng có thể chứa mật khẩu và các
thông tin nhạy cảm. Để gỡ lỗi sự cố tìm nạp thư, lấy "dấu vết ngăn xếp" từ
kết xuất cốt lõi thường là cách nhanh nhất để giải quyết vấn đề và khi đăng vấn đề của bạn
trên một danh sách gửi thư, các nhà phát triển có thể yêu cầu bạn cung cấp một "backtrace".

1. Để nhận được các đường truyền ngược hữu ích, thư tìm nạp cần được cài đặt mà không bị tước bỏ
các ký hiệu biên dịch của nó. Thật không may, hầu hết các gói nhị phân được cài đặt đều
và các tệp lõi từ các chương trình bị tước ký hiệu là vô giá trị. Vì vậy, bạn có thể cần
biên dịch lại thư tìm nạp. Trên nhiều hệ thống, bạn có thể nhập

tập tin `tìm nạp thư điện tử`

để tìm hiểu xem thư tìm nạp có bị tước ký hiệu hay không. Nếu của bạn chưa được đánh dấu, tốt thôi,
tiếp tục, nếu nó bị loại bỏ, trước tiên bạn cần phải biên dịch lại mã nguồn. Bạn không
thường cần cài đặt fetchmail để gỡ lỗi nó.

2. Môi trường shell bắt đầu fetchmail cần kích hoạt kết xuất lõi. Chìa khóa là
"kích thước lõi (tệp) tối đa" thường có thể được định cấu hình bằng công cụ có tên "giới hạn" hoặc
"ulimit". Xem tài liệu về shell của bạn để biết thêm chi tiết. Trong bash shell phổ biến,
"ulimit -Sc không giới hạn" sẽ cho phép kết xuất lõi.

3. Bạn cũng cần cho fetchmail biết để cho phép kết xuất lõi. Để làm điều này, hãy chạy thư tìm nạp với
các -d0 -v tùy chọn. Việc thêm cũng thường dễ dàng hơn --nosyslog -N là tốt.

Cuối cùng, bạn cần tạo lại sự cố. Bạn chỉ có thể bắt đầu tìm nạp thư từ thư mục
nơi bạn đã biên dịch nó bằng cách gõ ./nhận thư, vì vậy dòng lệnh hoàn chỉnh sẽ bắt đầu bằng
./nhận thư -Nvd0 --nosyslog và có lẽ liệt kê các tùy chọn khác của bạn.

Sau sự cố, hãy chạy trình gỡ lỗi của bạn để lấy kết xuất lõi. Trình gỡ lỗi thường sẽ là
GNU GDB, sau đó bạn có thể nhập (điều chỉnh đường dẫn nếu cần) gdb ./nhận thư tìm nạp.core và
sau đó, sau khi GDB đã khởi động và đọc tất cả các tệp của nó, hãy nhập đường lùi Full, lưu
đầu ra (sao chép và dán sẽ được thực hiện, dấu lùi sẽ được đọc bởi con người) và sau đó nhập bỏ thuốc lá đến
để lại gdb. Lưu ý: trên một số hệ thống, các tệp lõi có các tên khác nhau, chúng có thể chứa
một số thay vì tên chương trình hoặc số và tên, nhưng nó thường sẽ có "lõi"
như một phần của tên của họ.

SỰ TƯƠNG TÁC CÙNG VỚI RFC 822

Khi cố gắng xác định địa chỉ gốc của một thư, fetchmail sẽ xem xét
tiêu đề theo thứ tự sau:

Return-Path:
Người gửi phản hồi: (bị bỏ qua nếu không chứa ký hiệu @ hoặc!)
Người gửi: (bị bỏ qua nếu nó không chứa @ hoặc!)
Phẫn nộ-Từ:
Từ:
Trả lời:
Rõ ràng-Từ:

Địa chỉ gốc được sử dụng để ghi nhật ký và để đặt địa chỉ MAIL FROM khi
chuyển tiếp tới SMTP. Đơn đặt hàng này nhằm đối phó một cách linh hoạt với việc nhận danh sách gửi thư
tin nhắn ở chế độ nhiều phông nền. Mục đích là nếu địa chỉ cục bộ không tồn tại,
thư bị trả lại sẽ không được trả lại một cách mù quáng cho tác giả hoặc cho chính danh sách, mà là
cho trình quản lý danh sách (điều này ít gây khó chịu hơn).

Trong chế độ đa phông nền, tiêu đề đích được xử lý như sau: Đầu tiên, tìm nạp thư trông
cho tiêu đề được chỉ định bởi tùy chọn 'phong bì' để xác định cục bộ
địa chỉ người nhận. Nếu thư được gửi đến nhiều hơn một người nhận, dòng Đã nhận
sẽ không chứa bất kỳ thông tin nào liên quan đến địa chỉ người nhận.

Sau đó, fetchmail tìm kiếm các dòng Resent-To :, Resent-Cc :, và Resent-Bcc:. Nếu họ
tồn tại, chúng phải chứa những người nhận cuối cùng và được ưu tiên hơn
Tới: / Cc: / Bcc: đối chiếu. Nếu dòng Resent- * không tồn tại, các dòng To :, Cc :, Bcc: and
Rõ ràng-To: dòng được tìm kiếm. (Sự hiện diện của một Lời oán thán: được hiểu là ngụ ý rằng
người được giới thiệu bởi địa chỉ Tới: đã nhận được bản sao gốc của
thư.)

CẤU HÌNH VÍ DỤ

Lưu ý rằng mặc dù có nhiều khai báo mật khẩu trong rất nhiều ví dụ dưới đây,
điều này chủ yếu dành cho mục đích minh họa. Chúng tôi khuyên bạn nên lưu trữ các cặp tài khoản / mật khẩu trong
tệp $ HOME / .netrc của bạn, nơi chúng có thể được sử dụng không chỉ bằng thư tìm nạp mà còn bằng cách ftp(1)
các chương trình khác.

Định dạng cơ bản là:

bỏ phiếu TÊN MÁY CHỦ giao thức BẢO VỆ tên truy nhập TÊN mật khẩu PASSWORD

Ví dụ:

thăm dò ý kiến ​​giao thức pop.provider.net tên người dùng pop3 "jsmith" mật khẩu "secret1"

Hoặc, sử dụng một số từ viết tắt:

thăm dò ý kiến ​​pop.provider.net proto pop3 người dùng "jsmith" mật khẩu "secret1"

Nhiều máy chủ có thể được liệt kê:

thăm dò ý kiến ​​pop.provider.net người dùng proto pop3 "jsmith" vượt qua "secret1"
thăm dò ý kiến ​​khác.provider.net người dùng proto pop2 "John.Smith" vượt qua "My ^ Hat"

Đây là phiên bản tương tự với nhiều khoảng trắng hơn và một số từ nhiễu:

thăm dò ý kiến ​​pop.provider.net proto pop3
người dùng "jsmith", với mật khẩu secret1, là "jsmith" ở đây;
thăm dò ý kiến ​​khác.provider.net proto pop2:
người dùng "John.Smith", với mật khẩu "My ^ Hat", là "John.Smith" ở đây;

Nếu bạn cần bao gồm khoảng trắng trong một chuỗi tham số hoặc bắt đầu phần sau bằng một số,
đặt chuỗi trong dấu ngoặc kép. Như vậy:

thăm dò ý kiến ​​mail.provider.net với proto pop3:
người dùng "jsmith" có mật khẩu "4u nhưng bạn không thể krak cái này"
là jws ở đây và muốn mda "/ bin / mail"

Bạn có thể có mô tả máy chủ ban đầu có từ khóa 'mặc định' thay vì
'cuộc thăm dò' theo sau là một cái tên. Bản ghi như vậy được hiểu là mặc định cho tất cả các truy vấn
sử dụng. Nó có thể bị ghi đè bởi các mô tả máy chủ riêng lẻ. Vì vậy, bạn có thể viết:

mặc định proto pop3
người dùng "jsmith"
thăm dò ý kiến ​​pop.provider.net
vượt qua "secret1"
thăm dò ý kiến ​​mail.provider.net
người dùng "jjsmith" có mật khẩu "secret2"

Có thể chỉ định nhiều hơn một người dùng trên mỗi máy chủ. Từ khóa 'người dùng' dẫn đến một
mô tả người dùng và mọi đặc tả người dùng trong mục nhập nhiều người dùng phải bao gồm nó.
Đây là một ví dụ:

thăm dò ý kiến ​​pop.provider.net cổng proto pop3 3111
người dùng "jsmith" với mật khẩu "secret1" là "smith" ở đây
người dùng jones với pass "secret2" là "jjones" ở đây giữ

Điều này liên kết tên người dùng cục bộ 'smith' với tên người dùng pop.provider.net 'jsmith' và
tên người dùng cục bộ 'jjones' với tên người dùng pop.provider.net 'jones'. Thư cho 'jones'
được lưu trên máy chủ sau khi tải xuống.

Dưới đây là cấu hình truy xuất đơn giản cho hộp thư nhiều ngăn trông như thế nào:

thăm dò ý kiến ​​pop.provider.net:
maildrop của người dùng với pass secret1 tới golux 'Hurkle' = 'happy' snark ở đây

Điều này nói rằng hộp thư của tài khoản 'maildrop' trên máy chủ là một hộp đa hồ sơ và
rằng các thư trong đó phải được phân tích cú pháp cho các tên người dùng máy chủ 'golux', 'ridkle' và
"snark". Nó chỉ định thêm rằng 'golux' và 'snark' có cùng tên trên máy khách
như trên máy chủ, nhưng thư dành cho người dùng máy chủ 'vượt rào' phải được gửi đến người dùng máy khách
'sung sướng'.

Lưu ý việc này nhận thư, cho đến phiên bản 6.3.4, KHÔNG cho phép thông số kỹ thuật đầy đủ của người dùng @ miền
ở đây, những điều này sẽ không bao giờ phù hợp. Nhận thư 6.3.5 và mới hơn hỗ trợ user @ domain
thông số kỹ thuật ở phía bên trái của ánh xạ người dùng.

Đây là một ví dụ về một loại kết nối multidrop khác:

thăm dò ý kiến ​​pop.provider.net localdomains loonytoons.org toons.org
phong bì X-Envelope-To
maildrop của người dùng với pass secret1 tới * tại đây

Điều này cũng nói rằng hộp thư của tài khoản 'maildrop' trên máy chủ là một hộp đa hồ sơ.
Nó cho fetchmail biết rằng bất kỳ địa chỉ nào trong miền loonytoons.org hoặc toons.org (bao gồm
địa chỉ miền phụ như '[email được bảo vệ]') nên được chuyển qua
trình nghe SMTP cục bộ mà không cần sửa đổi. Hãy cẩn thận với các vòng lặp thư nếu bạn làm điều này!

Đây là một cấu hình ví dụ sử dụng ssh và tùy chọn plugin. Các truy vấn được thực hiện
trực tiếp trên stdin và stdout của imapd qua ssh. Lưu ý rằng trong thiết lập này, IMAP
xác thực có thể được bỏ qua.

thăm dò ý kiến ​​mailhost.net với proto imap:
plugin "ssh% h / usr / sbin / imapd" auth ssh;
người dùng esr là esr ở đây

CÁC SỬ DỤNG VÀ LẠM DỤNG OF ĐA NĂNG HỘP THƯ

Sử dụng tính năng nhiều người nhận cục bộ một cách thận trọng - nó có thể gây khó khăn. Tất cả multidrop
các tính năng không hiệu quả trong chế độ ETRN và ODMR.

Ngoài ra, lưu ý rằng trong chế độ nhiều phông chữ, các thư trùng lặp sẽ bị loại bỏ. Một mẩu thư là
được coi là trùng lặp nếu nó có cùng ID thư với thư ngay trước đó
và nhiều hơn một người nhận. Những dòng thông báo như vậy có thể được tạo ra khi các bản sao của một
tin nhắn được gửi đến nhiều người dùng sẽ được gửi đến một hộp nhiều phông nền.

Tiêu đề vs. Phong bì địa chỉ
Vấn đề cơ bản là do máy chủ gửi thư của bạn chuyển thư của nhiều người trong một
hộp thư đơn lẻ, bạn có thể đã vứt bỏ thông tin quan trọng tiềm ẩn về người mà mỗi
thư thực sự đã được gửi đến ('địa chỉ phong bì', trái ngược với tiêu đề
địa chỉ trong tiêu đề RFC822 Tới / Cc - Bcc không khả dụng ở đầu nhận).
'Địa chỉ phong bì' này là địa chỉ bạn cần để định tuyến lại thư đúng cách.

Đôi khi nhận thư có thể suy ra địa chỉ phong bì. Nếu MTA của máy chủ thư là gửi thư
và mục thư chỉ có một người nhận, MTA sẽ viết điều khoản 'bằng / cho'
đưa người nhận địa chỉ phong bì vào tiêu đề Đã nhận của nó. Nhưng điều này không hoạt động đáng tin cậy
đối với các MTA khác, cũng như nếu có nhiều hơn một người nhận. Theo mặc định, nhận thư tìm kiếm
địa chỉ phong bì trong những dòng này; bạn có thể khôi phục mặc định này với -E "Đã nhận" hoặc
'phong bì đã nhận'.

As a hơn thay thế, một số trình nghe SMTP và / hoặc máy chủ thư chèn một tiêu đề vào mỗi
tin nhắn có chứa một bản sao của các địa chỉ trên phong bì. Tiêu đề này (khi nó tồn tại) là
thường là 'X-Original-To', 'Delivered-To' hoặc 'X-Envelope-To'. Giả định của Fetchmail về
điều này có thể được thay đổi bằng tùy chọn -E hoặc 'phong bì'. Lưu ý rằng viết phong bì
tiêu đề của loại này hiển thị tên của người nhận (bao gồm cả người nhận bản sao ẩn)
tất cả người nhận tin nhắn, vì vậy ngược dòng phải lưu trữ một bản sao của tin nhắn cho mỗi
người nhận để tránh trở thành một vấn đề riêng tư.

Postfix, kể từ phiên bản 2.0, viết tiêu đề X-Original-To: chứa bản sao của
phong bì như nó đã được nhận.

Qmail và Postfix thường viết tiêu đề 'Đã gửi đến' khi gửi thư đến
cuộn thư và sử dụng nó để tránh vòng lặp thư. Tuy nhiên, miền ảo Qmail sẽ có tiền tố
tên người dùng với một chuỗi thường khớp với miền của người dùng. Để loại bỏ tiền tố này
bạn có thể sử dụng tùy chọn -Q hoặc 'qvirtual'.

Đôi khi, thật không may, cả hai phương pháp này đều không hoạt động. Đó là điểm khi bạn
nên liên hệ với ISP của bạn và yêu cầu họ cung cấp tiêu đề phong bì như vậy và bạn nên
không sử dụng multidrop trong tình huống này. Khi tất cả chúng đều không thành công, fetchmail phải quay trở lại
nội dung của tiêu đề Đến / Cc (tiêu đề Bcc không khả dụng - xem bên dưới) để cố gắng xác định
người nhận địa chỉ - và những người này không đáng tin cậy. Đặc biệt, phần mềm danh sách gửi thư
thường gửi thư chỉ có địa chỉ quảng bá danh sách trong tiêu đề Tới.

Lưu ý việc này a tương lai phiên bản of nhận thư có thể tẩy Tới / Cc phân tích cú pháp!

Thời Gian nhận thư không thể suy ra địa chỉ người nhận là địa phương và người nhận dự định
địa chỉ là bất kỳ ai khác ngoài người dùng đang gọi của fetchmail, thư sẽ được mất đi. Đây là cái gì
làm cho tính năng đa phông trở nên rủi ro nếu không có thông tin phong bì thích hợp.

Một vấn đề liên quan là khi bạn sao chép thư, thông tin Bcc là
thực hiện có thể dưới dạng địa chỉ phong bì (địa chỉ này bị xóa khỏi tiêu đề bằng cách gửi thư
máy chủ, do đó, fetchmail chỉ có thể nhìn thấy nó nếu có tiêu đề X-Envelope-To). Vì vậy, mù-
sao chép cho ai đó nhận được thư qua một liên kết nhiều thư viện tìm nạp sẽ không thành công trừ khi
Máy chủ lưu trữ mailerver thường xuyên ghi X-Envelope-To hoặc một tiêu đề tương đương vào các thư trong
maildrop của bạn.

In phần kết luận, gửi thư danh sách và Bcc'd thư có thể có thể công việc if các máy chủ bạn tìm nạp
từ

(1) cửa hàng một bản sao of các tin nhắn mỗi người nhận in qua một vài thao tác đơn giản về miền và

(2) hồ sơ các phong bì thông tin in a đặc biệt cú đội đầu (X-Bản gốc-To, Đã gửi đến,
X-Phong bì-To).

tốt cách Đến Sử dụng Nhiều giọt Hộp thư
Nhiều tên cục bộ có thể được sử dụng để quản lý danh sách gửi thư từ phía máy khách của
nhận thư thu thập. Giả sử tên của bạn là 'esr' và bạn muốn cả hai tự chọn
gửi thư và duy trì một danh sách gửi thư có tên (giả sử) "fetchmail-friends" và bạn muốn giữ lại
danh sách bí danh trên máy khách của bạn.

Trên máy chủ của bạn, bạn có thể đặt bí danh 'fetchmail-friends' thành 'esr'; sau đó, trong của bạn .fetchmailrc,
khai báo 'to esr fetchmail-friends here'. Sau đó, khi thư bao gồm 'tìm nạp thư-bạn bè' với tư cách là
địa chỉ cục bộ được tìm nạp, tên danh sách sẽ được thêm vào danh sách người nhận
trình nghe SMTP của bạn nhìn thấy. Do đó, nó sẽ được mở rộng bí danh tại địa phương. Chắc chắn rằng
bao gồm 'esr' trong phần mở rộng bí danh cục bộ của những người bạn trong fetchmail, nếu không bạn sẽ không bao giờ thấy thư
chỉ được gửi đến danh sách. Ngoài ra, hãy chắc chắn rằng người nghe của bạn đã đặt tùy chọn "tôi cũng vậy"
(tùy chọn dòng lệnh -oXm của sendmail hoặc khai báo OXm) để tên của bạn không bị xóa khỏi
mở rộng bí danh trong tin nhắn bạn gửi.

Tuy nhiên, thủ thuật này không phải là không có vấn đề. Bạn sẽ bắt đầu thấy điều này khi có một tin nhắn
đến trong đó chỉ được gửi đến một danh sách gửi thư mà bạn làm không đã tuyên bố là một địa phương
Tên. Mỗi thư như vậy sẽ có tiêu đề 'X-Fetchmail-Warning' được tạo
bởi vì fetchmail không thể tìm thấy tên cục bộ hợp lệ trong địa chỉ người nhận. Như là
mặc định thông báo (như được mô tả ở trên) được gửi đến người dùng cục bộ đang chạy
nhận thư, nhưng chương trình không có cách nào để biết rằng đó thực sự là điều đúng đắn.

Bad cách Đến Lạm dụng Nhiều giọt Hộp thư
Hộp thư đa hồ sơ và nhận thư phục vụ nhiều người dùng trong chế độ daemon không trộn lẫn. Các
vấn đề, một lần nữa, là thư từ danh sách gửi thư, thường không có một cá nhân
địa chỉ người nhận trên đó. Trừ phi nhận thư có thể suy ra một địa chỉ phong bì, thư như vậy sẽ
chỉ vào tài khoản đang chạy fetchmail (có thể là root). Ngoài ra, những người dùng sao chép một cách mù quáng đang
rất có thể không bao giờ thấy thư của họ.

Nếu bạn muốn sử dụng nhận thư để truy xuất thư cho nhiều người dùng từ một thư duy nhất
thả qua POP hoặc IMAP, suy nghĩ lại (và đọc lại phần về địa chỉ tiêu đề và phong bì
bên trên). Sẽ thông minh hơn nếu chỉ để thư nằm trong hàng đợi của người gửi thư và sử dụng
Chế độ ETRN hoặc ODMR của fetchmail để kích hoạt gửi SMTP định kỳ (tất nhiên, điều này có nghĩa là
bạn phải thăm dò ý kiến ​​thường xuyên hơn thời gian hết hạn của người gửi thư). Nếu bạn không thể
sắp xếp điều này, hãy thử thiết lập nguồn cấp dữ liệu UUCP.

Nếu bạn hoàn toàn phải sử dụng multidrop cho mục đích này, đảm bảo rằng máy chủ thư của bạn viết một
tiêu đề địa chỉ phong bì mà thư tìm nạp có thể thấy. Nếu không bạn sẽ mất thư và nó sẽ
trở lại để ám ảnh bạn.

Sự chạy mau Up Nhiều giọt Kiểm tra
Thông thường, khi nhiều người dùng được khai báo nhận thư trích xuất địa chỉ người nhận là
được mô tả ở trên và kiểm tra từng phần máy chủ bằng DNS để xem liệu đó có phải là bí danh của
máy chủ thư. Nếu vậy, ánh xạ tên được mô tả trong khai báo "tới ... đây" được thực hiện
và thư được gửi tại địa phương.

Đây là một phương pháp tiện lợi nhưng cũng chậm. Để tăng tốc độ, hãy khai báo trước các bí danh của máy chủ thư
với 'aka'; chúng sẽ được kiểm tra trước khi hoàn tất việc tra cứu DNS. Nếu bạn chắc chắn về cái tên của mình
danh sách chứa tất cả các Bí danh DNS của máy chủ thư (và tất cả các tên MX trỏ vào nó - lưu ý
điều này có thể thay đổi trong phiên bản trong tương lai) bạn có thể khai báo 'no dns' để ngăn chặn tra cứu DNS
hoàn toàn và có thể khớp với danh sách aka.

SOCKS

Hỗ trợ cho vớ4 / 5 là một biên dịch thời gian tùy chọn cấu hình. Sau khi được biên dịch, tìm nạp thư
sẽ luôn sử dụng các thư viện và cấu hình vớ trên hệ thống của bạn, không có bất kỳ hoạt động nào-
chuyển thời gian trong thư tìm nạp - nhưng bạn vẫn có thể định cấu hình SOCKS: bạn có thể chỉ định
Tệp cấu hình SOCKS được sử dụng trong SOCKS_CONF biến môi trường.

Ví dụ: nếu bạn muốn bỏ qua hoàn toàn proxy SOCKS và có thư tìm nạp
kết nối trực tiếp, chẳng hạn như bạn có thể truyền SOCKS_CONF = / dev / null vào môi trường
(thêm các tùy chọn dòng lệnh thông thường của bạn - nếu có - vào cuối dòng này):

env SOCKS_CONF = / dev / null fetchmail

EXIT MÃ

Để tạo điều kiện cho việc sử dụng nhận thư trong tập lệnh shell, mã trạng thái thoát được trả về
đưa ra một dấu hiệu về những gì đã xảy ra trong một kết nối nhất định.

Các mã thoát được trả về bởi nhận thư như sau:

0 Một hoặc nhiều thư đã được truy xuất thành công (hoặc, nếu tùy chọn -c là
đã chọn, được tìm thấy đang chờ nhưng không được truy xuất).

1 Không có thư nào đang chờ truy xuất. (Có thể vẫn còn thư cũ trên
nhưng không được chọn để truy xuất.) Nếu bạn không muốn lỗi "no mail"
điều kiện (ví dụ: đối với công việc cron), sử dụng trình bao tương thích với POSIX và thêm

|| [$? -q 1]

ở cuối dòng lệnh fetchmail, lưu ý rằng điều này để lại 0 nguyên, bản đồ 1
thành 0 và ánh xạ tất cả các mã khác thành 1. Xem thêm mục # C8 trong Câu hỏi thường gặp.

2 Đã xảy ra lỗi khi cố gắng mở ổ cắm để lấy thư. nếu bạn
không biết ổ cắm là gì, đừng lo lắng về nó - chỉ cần coi đây là một
'lỗi không thể khôi phục'. Lỗi này cũng có thể do thư tìm nạp giao thức muốn
để sử dụng không được liệt kê trong / etc / services.

3 Bước xác thực người dùng không thành công. Điều này thường có nghĩa là id người dùng không hợp lệ,
mật khẩu hoặc id APOP đã được chỉ định. Hoặc nó có thể có nghĩa là bạn đã cố gắng chạy thư tìm nạp
trong những trường hợp mà nó không có đầu vào tiêu chuẩn được gắn vào một thiết bị đầu cuối và
không thể nhắc thiếu mật khẩu.

4 Đã phát hiện một số loại lỗi giao thức nghiêm trọng.

5 Có lỗi cú pháp trong các đối số của nhận thưhoặc kết nối trước hoặc sau
Lệnh không thành công.

6 Tệp điều khiển chạy có quyền không hợp lệ.

7 Có một tình trạng lỗi do máy chủ báo cáo. Cũng có thể bắn nếu nhận thư
hết thời gian chờ đợi máy chủ.

8 Lỗi loại trừ phía máy khách. Điều này có nghĩa là nhận thư hoặc đã tìm thấy một bản sao khác của
bản thân nó đã chạy hoặc không thành công theo cách mà nó không chắc liệu khác
bản sao đang chạy.

9 Bước xác thực người dùng không thành công do máy chủ phản hồi "khóa bận". Cố gắng
một lần nữa sau một thời gian ngắn tạm dừng! Lỗi này không được triển khai cho tất cả các giao thức, cũng như
cho tất cả các máy chủ. Nếu không được triển khai cho máy chủ của bạn, "3" sẽ được trả về thay thế,
xem ở trên. Có thể được trả lại khi nói chuyện với qpopper hoặc các máy chủ khác có thể
trả lời bằng "khóa máy bận" hoặc một số văn bản tương tự có chứa từ "khóa".

10 The nhận thư chạy không thành công khi cố gắng mở cổng SMTP hoặc giao dịch.

11 Lỗi DNS nghiêm trọng. Fetchmail đã gặp lỗi khi thực hiện tra cứu DNS tại
khởi động và không thể tiếp tục.

12 Không thể mở tệp lô BSMTP.

13 Cuộc thăm dò được kết thúc bởi một giới hạn tìm nạp (xem tùy chọn --fetchlimit).

14 Chỉ báo máy chủ bận.

23 Lỗi nội bộ. Bạn sẽ thấy một thông báo về lỗi tiêu chuẩn với các chi tiết.

24 - 26, 28, 29
Đây là những mã nội bộ và không được xuất hiện bên ngoài.

Thời Gian nhận thư truy vấn nhiều hơn một máy chủ, trạng thái trả về là 0 nếu bất kì truy vấn thành công
thư đã truy xuất. Nếu không, trạng thái lỗi trả về là trạng thái của máy chủ lưu trữ cuối cùng được truy vấn.

Sử dụng fetchmailconf trực tuyến bằng các dịch vụ onworks.net