httrack(1) General Commands Manual httrack(1)

httrack - مرورگر آفلاین: کپی وب‌سایت‌ها در یک دایرکتوری محلی

httrack [ url ]... [ -filter ]... [ +filter ]... [ -O, --path ] [ -w, --mirror ] [ -W, --mirror-wizard ] [ -g, --get-files ] [ -i, --continue ] [ -Y, --mirrorlinks ] [ -P, --proxy ] [ -%f, --httpproxy-ftp[=0] ] [ -%b, --bind ] [ -rN, --depth[=N] ] [ -%eN, --ext-depth[=N] ] [ -mN, --max-files[=N] ] [ -MN, --max-size[=N] ] [ -EN, --max-time[=N] ] [ -AN, --max-rate[=N] ] [ -%cN, --connection-per-second[=N] ] [ -%G, --pause ] [ -GN, --max-pause[=N] ] [ -cN, --sockets[=N] ] [ -TN, --timeout[=N] ] [ -RN, --retries[=N] ] [ -JN, --min-rate[=N] ] [ -HN, --host-control[=N] ] [ -%P, --extended-parsing[=0] ] [ -n, --near ] [ -t, --test ] [ -%L, --list ] [ -%S, --urllist ] [ -%m, --sitemap ] [ -NN, --structure[=N] ] [ -%N, --delayed-type-check[=N] ] [ -%D, --cached-delayed-type-check[=0] ] [ -%M, --mime-html[=0] ] [ -%Z, --single-file[=0] ] [ -LN, --long-names[=N] ] [ -KN, --keep-links[=N] ] [ -x, --replace-external ] [ -%x, --disable-passwords[=0] ] [ -%q, --include-query-string[=0] ] [ -%g, --strip-query ] [ -%C, --host-alias ] [ -o, --generate-errors[=N] ] [ -X, --purge-old[=0] ] [ -%p, --preserve ] [ -%T, --utf8-conversion[=0] ] [ -bN, --cookies[=N] ] [ -%K, --cookies-file ] [ -%Y, --why ] [ -u, --check-type[=N] ] [ -j, --parse-java[=N] ] [ -sN, --robots[=N] ] [ -%h, --http-10[=0] ] [ -%k, --keep-alive[=0] ] [ -%z, --disable-compression[=0] ] [ -%B, --tolerant[=0] ] [ -%s, --updatehack[=0] ] [ -%u, --urlhack[=0] ] [ -%A, --assume ] [ -@iN, --protocol[=N] ] [ -%w, --disable-module ] [ -F, --user-agent ] [ -%R, --referer ] [ -%E, --from ] [ -%F, --footer ] [ -%l, --language ] [ -%a, --accept ] [ -%X, --headers ] [ -C, --cache[=N] ] [ -k, --store-all-in-cache ] [ -%r, --warc ] [ -%d, --changes[=0] ] [ -%n, --do-not-recatch[=0] ] [ -%v, --display[=N] ] [ -Q, --do-not-log ] [ -q, --quiet ] [ -z, --extra-log ] [ -Z, --debug-log ] [ -v, --verbose ] [ -f, --file-log ] [ -f2, --single-log ] [ -I, --index[=0] ] [ -%i, --build-top-index[=0] ] [ -%I, --search-index[=N] ] [ -pN, --priority[=N] ] [ -S, --stay-on-same-dir ] [ -D, --can-go-down ] [ -U, --can-go-up ] [ -B, --can-go-up-and-down ] [ -a, --stay-on-same-address ] [ -d, --stay-on-same-domain ] [ -l, --stay-on-same-tld ] [ -e, --go-everywhere ] [ -%H, --debug-headers ] [ -%!, --disable-security-limits[=0] ] [ -V, --userdef-cmd ] [ -%W, --callback ] [ -y, --background-on-suspend[=0] ] [ -K, --keep-links[=N] ]

httrack به شما امکان می‌دهد یک وب‌سایت وب جهان‌گستر را از اینترنت در یک دایرکتوری محلی بارگیری کنید، تمامی دایرکتوری‌ها را به‌صورت بازگشتی بسازید و فایل‌های HTML، تصاویر و سایر پرونده‌ها را از کارساز به رایانه خود منتقل کنید. HTTrack ساختار پیوندهای نسبی وب‌سایت اصلی را بازآرایی می‌کند. کافی است یکی از صفحات وب‌سایت «آینه‌شده» را در مرورگر خود باز کنید تا بتوانید درست مانند مشاهده آنلاین، پیوند به پیوند در سایت مرور کنید. HTTrack همچنین می‌تواند وب‌سایت‌های آینه‌شده موجود را به‌روزرسانی کند و بارگیری‌های متوقف‌شده را ادامه دهد.

httrack www.example.com/bob/
آینه‌کردن سایت www.example.com/bob/ و تنها همین سایت
httrack www.example.com/bob/ other.example.com/mike/ +*.com/*.jpg -mime:application/*
آینه‌کردن هر دو سایت با هم (با پیوندهای مشترک) و پذیرفتن تمامی فایل‌های .jpg روی سایت‌های .com
httrack www.example.com/bob/bobby.html +* -r6
httrack www.example.com/bob/bobby.html --spider -P proxy.example.com:8080
httrack --update
httrack --continue

مسیر ذخیره سایت آینه‌شده/فایل‌های گزارش+حافظه موقت (-O path_mirror[,path_cache_and_logfiles]) (--path <param>)

*آینه‌کردن وب‌سایت‌ها (--mirror)
آینه‌کردن وب‌سایت‌ها، نیمه‌خودکار (پرسیدن سوالات) (--mirror-wizard)
فقط دریافت فایل‌ها (ذخیره در دایرکتوری جاری) (--get-files)
ادامه یک آینه‌سازی متوقف‌شده با استفاده از حافظه موقت (--continue)
آینه‌کردن تمامی پیوندهای موجود در صفحات سطح اول (پیوندهای آینه) (--mirrorlinks)

استفاده از پیشکار/پروکسی (-P [socks5://|connect://][user:pass@]proxy:port) (--proxy <param>)
-%f
*استفاده از پیشکار برای ftp (مقدار f0 یعنی استفاده نکن) (--httpproxy-ftp[=0])
-%b
استفاده از این نام میزبان محلی برای ایجاد/ارسال درخواست‌ها (-%b hostname) (--bind <param>)

تنظیم عمق آینه‌سازی روی N (* r9999) (--depth[=N])
-%eN
تنظیم عمق پیوندهای خارجی روی N (* %e0) (--ext-depth[=N])
حداکثر طول فایل برای یک فایل غیر HTML (--max-files[=N])
حداکثر طول فایل برای غیر HTML (مقدار N) و HTML (مقدار N2)
حداکثر حجم کلی که می‌تواند بارگذاری/پویش شود (--max-size[=N])
حداکثر زمان آینه‌سازی برحسب ثانیه (۶۰=۱ دقیقه، ۳۶۰۰=۱ ساعت) (--max-time[=N])
حداکثر نرخ انتقال برحسب بایت/ثانیه (1000=حداکثر 1KB/s) (--max-rate[=N])
-%cN
حداکثر تعداد اتصال‌ها در ثانیه (*%c5) (--connection-per-second[=N])
-%G
مکث تصادفی بین MIN[:MAX] ثانیه میان دریافت فایل‌ها (مثلاً %G5:10) (--pause <param>)
مکث در انتقال در صورت رسیدن به N بایت، و انتظار تا زمانی که فایل قفل حذف شود (--max-pause[=N])

تعداد اتصال‌های هم‌روند (*c4) (--sockets[=N])
مهلت زمانی، تعداد ثانیه‌هایی که پس از آن پیوند بی‌پاسخ بسته می‌شود؛ همچنین وضوح نام میزبان را محدود می‌کند (--timeout[=N])
تعداد تلاش‌های مجدد در صورت اتمام مهلت زمانی یا خطاهای غیرمهلک (*R1) (--retries[=N])
کنترل ترافیک، حداقل نرخ انتقال (بایت/ثانیه) قابل‌تحمل برای یک پیوند (--min-rate[=N])
صرف‌نظر کردن از میزبان در صورت: 0=هرگز، 1=پایان مهلت زمانی، 2=کندی، 3=پایان مهلت زمانی یا کندی (--host-control[=N])
-%P
*تجزیه گسترده، تلاش برای تجزیه تمامی پیوندها، حتی درون تگ‌های ناشناخته یا جاوااسکریپت (%P0 یعنی استفاده نکن) (--extended-parsing[=0])
دریافت فایل‌های غیر HTML که «نزدیک» یک فایل HTML قرار دارند (مانند تصویری که در خارج واقع شده است) (--near)
آزمودن تمامی نشانی‌های وب (حتی موارد ممنوع‌شده) (--test)
-%L
<file> افزودن تمامی نشانی‌های وب موجود در این فایل متنی (یک نشانی در هر خط) (--list <param>)
-%S
<file> افزودن تمامی قواعد پویش موجود در این فایل متنی (یک قاعده پویش در هر خط) (--urllist <param>)
-%m
شروع خزش از نقشه‌سایت (sitemap) سایت (ابتدا خط Sitemap: در robots.txt و سپس /sitemap.xml)؛ گزینه --sitemap-url URL یکی را به‌طور صریح مشخص می‌کند. نقشه‌سایتی که نام ببرید یا سایتی که اعلام شده باشد، حتی با وجود Disallow در robots.txt واکشی می‌شود؛ تنها /sitemap.xml حدس‌زده‌شده از آن پیروی می‌کند. نشانی‌های وب یافت‌شده همچنان از تمامی قواعد فیلتر و دامنه عبور می‌کنند (--sitemap)

نوع ساختار (0 *ساختار اصلی، +1: موارد زیر را ببینید) (--structure[=N])
یا ساختار تعریف‌شده توسط کاربر (-N "%h%p/%n%q.%t"، --structure یا --user-structure)
گزینه --structure یک پیش‌تنظیم یا الگو می‌پذیرد: گزینه -N1L0 چندین گزینه کوتاه را ادغام می‌کند، اما --structure=1L0 پذیرفته نمی‌شود
-%N
بررسی با تأخیر نوع، هیچ آزمون پیوندی انجام نده اما در عوض منتظر بمان تا بارگیری فایل‌ها شروع شود (آزمایشی) (%N0 استفاده نکن، %N1 استفاده برای پسوندهای ناشناخته، * %N2 همیشه استفاده کن) (--delayed-type-check[=N])
-%D
بررسی با تأخیر نوع ذخیره‌شده در حافظه موقت، برای تسریع به‌روزرسانی‌ها منتظر دریافت نوع فایل از راه دور نمان (%D0 منتظر بمان، * %D1 منتظر نمان) (--cached-delayed-type-check[=0])
-%M
تولید یک بایگانی کامل کپسوله‌شده بر اساس RFC MIME با پسوند (.mht) (--mime-html[=0])
-%Z
پس از آینه‌سازی، هر صفحه ذخیره‌شده را بازنویسی کن به‌گونه‌ای که شیوه‌نامه‌ها، اسکریپت‌ها، تصاویر و فونت‌های آن به‌صورت درون‌خطی و با شناسه‌های data: URI گنجانده شوند، تا هر صفحه‌ای در هر جا با دوبار کلیک باز شود (پیوندهای میان صفحات به‌صورت نسبی باقی می‌مانند؛ صدا و ویدیو به‌صورت پیوند باقی می‌مانند)؛ گزینه --single-file-max-size N سقف هر منبع را تعیین می‌کند (پیش‌فرض ۱۰۴۸۵۷۶۰ بایت). گزینه %M ظرف بهتری است در جایی که مرورگری از خانواده کرومیوم در دسترس باشد: یک بایگانی واحد، بدون جریمه base64 روی متن، و ذخیره منابع مشترک فقط برای یک بار (--single-file[=0])
-%t
حفظ پسوند اصلی فایل، عدم بازنویسی آن از روی نوع MIME (مقدار %t0 یعنی بازنویسی کن)
نام‌های طولانی (L1 *نام‌های طولانی / L0 تبدیل به ۳-۸ / L2 سازگار با ISO9660) (--long-names[=N])
حفظ پیوندهای اصلی (مانند http://www.adr/link) (مقدار K0 *پیوند نسبی، K پیوندهای مطلق، K4 پیوندهای اصلی، K3 پیوندهای مطلق URI، و K5 پیوند پیشکار شفاف) (--keep-links[=N])
جایگزینی پیوندهای خارجی HTML با صفحات خطا (--replace-external)
-%x
عدم گنجاندن هیچ گذرواژه‌ای برای وب‌سایت‌های خارجی محافظت‌شده با گذرواژه (%x0 یعنی بگنجان) (--disable-passwords[=0])
-%q
*گنجاندن رشته پرس‌وجو (query string) برای فایل‌های محلی (بی‌فایده، صرفاً برای اطلاع) (%q0 یعنی نگنجان) (--include-query-string[=0])
-%g
حذف کلیدهای پرس‌وجو برای حذف موارد تکراری ([host/pattern=]key1,key2,...) (--strip-query <param>)
-%C
ادغام سایر نام‌های میزبان یک سایت روی آن ([scheme://]alias[,...]=[scheme://]host) (--host-alias <param>)
*ذخیره صفحات خطای کارساز (404 و...) (مقدار o0 یعنی نادیده بگیر) (--generate-errors[=N])
*پاک‌سازی فایل‌های قدیمی پس از به‌روزرسانی (X0 نگه‌داشتن فایل‌های حذفی) (--purge-old[=0])
-%p
حفظ فایل‌های HTML «همان‌گونه که هستند» (مشابه '-K4 -%F ""') (--preserve)
-%T
تبدیل پیوندها به UTF-8 (--utf8-conversion[=0])

پذیرش کوکی‌ها در cookies.txt (0=نپذیر، * 1=بپذیر) (--cookies[=N])
-%K
بارگذاری کوکی‌های اضافی از یک فایل cookies.txt نت‌اسکیپ (--cookies-file <param>)
-%Y
توضیح این‌که کدام قاعده فیلتر نشانی وب را می‌پذیرد یا رد می‌کند، سپس خروج (--why <param>)
بررسی نوع سند در صورت ناشناخته بودن (cgi، asp و...) (مقدار u0 یعنی بررسی نکن، * u1 یعنی بررسی کن به جز /، u2 یعنی همیشه بررسی کن) (--check-type[=N])
*تجزیه اسکریپت‌ها (j0 یعنی تجزیه نکن، ماسک بیتی: |1 تجزیه پیش‌فرض، |4 فایل‌های .js را تجزیه نکن، |8 رفتار تهاجمی نداشته باش) (--parse-java[=N])
پیروی از robots.txt و تگ‌های متای robots (0=هرگز، 1=گاهی اوقات، * 2=همیشه، 3=همیشه (حتی قواعد سخت‌گیرانه)) (--robots[=N])
-%h
اجبار به درخواست‌های HTTP/1.0 (کاهش ویژگی‌های به‌روزرسانی، فقط برای کارسازها یا پیشکارهای قدیمی) (--http-10[=0])
-%k
استفاده از keep-alive در صورت امکان، که تأخیر را برای فایل‌های کوچک و درخواست‌های آزمایشی به‌شدت کاهش می‌دهد (%k0 یعنی استفاده نکن) (--keep-alive[=0])
-%z
درخواست نکردن محتوای فشرده‌شده (%z0 یعنی درخواست کن) (--disable-compression[=0])
-%B
درخواست‌های بردبار (پذیرش پاسخ‌های نامعتبر در برخی کارسازها، اما غیراستاندارد است!) (--tolerant[=0])
-%s
ترفندهای به‌روزرسانی: ترفندهای گوناگون برای محدود کردن انتقال‌های مجدد هنگام به‌روزرسانی (اندازه یکسان، پاسخ جعلی و...) (--updatehack[=0])
-%u
ترفندهای نشانی وب: ترفندهای گوناگون برای محدود کردن نشانی‌های وب تکراری (حذف //، www.foo.com==foo.com و...) (--urlhack[=0])
صرف‌نظر کردن از یک بخش از ترفندهای نشانی: --keep-www-prefix (عدم یکسان‌سازی www.foo.com با foo.com)، --keep-double-slashes (حفظ //)، --keep-query-order (حفظ ترتیب پرس‌وجو ?b&a)
-%A
فرض کردن این‌که یک نوع (cgi، asp و...) همیشه به یک نوع MIME پیوند دارد (-%A php3,cgi=text/html;dat,bin=application/x-zip) (--assume <param>)
میان‌بر: '--assume standard' معادل است با -%A php2 php3 php4 php cgi asp jsp pl cfm nsf=text/html
همچنین می‌تواند برای تحمیل یک نوع فایل خاص استفاده شود: --assume foo.cgi=text/html
-@iN
پروتکل اینترنت (0=هر دو ipv6+ipv4، 4=فقط ipv4، 6=فقط ipv6) (--protocol[=N])
-%w
غیرفعال کردن یک ماژول MIME خارجی خاص (-%w httrack-plugin) (--disable-module <param>)

فیلد user-agent ارسالی در هدرهای HTTP (-F "user-agent name") (--user-agent <param>)
-%R
فیلد ارجاع‌دهنده (referer) پیش‌فرض ارسالی در هدرهای HTTP (--referer <param>)
-%E
نشانی ایمیل فرستنده (from) ارسالی در هدرهای HTTP (--from <param>)
-%F
رشته پانویس در کد HTML (-%F "Mirrored from {url} on {date}"؛ فیلدهای {addr} {path} {url} {date} {lastmodified} {version} {mime} {charset} {status} {size}، یا حالت قدیمی %s) (--footer <param>)
-%l
زبان ترجیحی (-%l "fr, en, jp, *" (--language <param>)
-%a
قالب‌های پذیرفته‌شده (-%a "text/html,image/png;q=0.9,*/*;q=0.1" (--accept <param>)
-%X
خط هدر HTTP اضافی (-%X "X-Magic: 42" (--headers <param>)

ایجاد/استفاده از حافظه موقت برای به‌روزرسانی‌ها و تلاش‌های مجدد (C0 بدون حافظه موقت، C1 حافظه موقت اولویت دارد، * C2 آزمودن به‌روزرسانی از قبل) (--cache[=N])
ذخیره تمامی فایل‌ها در حافظه موقت (اگر فایل‌ها روی دیسک باشند مفید نیست) (--store-all-in-cache)
-%r
نوشتن یک بایگانی ISO-28500 WARC/1.1؛ گزینه --warc-file NAME نام خروجی را تعیین می‌کند، --warc-max-size N قطعات را پس از N بایت می‌چرخاند، --warc-cdx همچنین یک نمایه مرتب‌شده CDXJ می‌نویسد، و --wacz همه آن را در قالب یک فایل WACZ بسته‌بندی می‌کند (--warc)
-%d
نوشتن فایل hts-changes.json شامل فهرستی از آنچه در این خزش نسبت به آینه پیشین جدید، تغییریافته، بدون‌تغییر یا حذف‌شده است (--changes[=0])
-%n
بارگیری مجدد نکردن فایل‌هایی که به‌صورت محلی حذف شده‌اند (--do-not-recatch[=0])
-%v
نمایش نام فایل‌های بارگیری‌شده روی صفحه (به‌صورت بلادرنگ) - * %v1 نسخه کوتاه - %v2 پویانمایی کامل (--display[=N])
بدون ثبت گزارش - حالت ساکت (--do-not-log)
بدون پرسش - حالت ساکت (--quiet)
ثبت گزارش - اطلاعات اضافی (--extra-log)
ثبت گزارش - اشکال‌زدایی (--debug-log)
ثبت گزارش روی صفحه نمایش (--verbose)
*ثبت گزارش در فایل‌ها (--file-log)
یک تک‌فایل گزارش (--single-log)
*ساخت یک نمایه (I0 یعنی نساز) (--index[=0])
-%i
ساخت یک نمایه بالا‌دستی برای یک پوشه پروژه (* %i0 یعنی نساز) (--build-top-index[=0])
-%I
ساخت یک نمایه قابل‌جستجو برای این آینه (* %I0 یعنی نساز) (--search-index[=N])

حالت اولویت: (* p3) (--priority[=N])
p0 فقط پویش کن، چیزی ذخیره نکن (برای بررسی پیوندها)
p1 فقط فایل‌های HTML را ذخیره کن
p2 فقط فایل‌های غیر HTML را ذخیره کن
*p3 تمامی فایل‌ها را ذخیره کن
p7 فایل‌های HTML را ابتدا دریافت کن، سپس سایر فایل‌ها را پردازش کن
ماندن در همان دایرکتوری (--stay-on-same-dir)
*تنها امکان رفتن به زیرپوشه‌ها (--can-go-down)
تنها امکان رفتن به دایرکتوری‌های بالاتر (--can-go-up)
امکان رفتن به بالا و پایین در ساختار دایرکتوری (--can-go-up-and-down)
*ماندن در همان نشانی (--stay-on-same-address)
ماندن در همان دامنه اصلی (--stay-on-same-domain)
ماندن در همان دامنه سطح‌بالا (TLD) (مانند: .com) (--stay-on-same-tld)
رفتن به همه جای وب (--go-everywhere)
-%H
اشکال‌زدایی هدرهای HTTP در فایل گزارش (--debug-headers)

-#test
فهرست خودآزمایی‌های موتور (اجرای یکی با -#test=NAME [args])
-#C
فهرست حافظه موقت (-#C '*.com/spider*.gif' (--debug-cache <param>)
-#R
تعمیر حافظه موقت (حافظه موقت آسیب‌دیده) (--repair-cache)
-#d
اشکال‌زدایی تجزیه‌کننده (--debug-parsing)
-#E
استخراج فراداده‌های حافظه موقت new.zip در meta.zip
-#f
همیشه فایل‌های گزارش تخلیه (flush) شوند (--advanced-flushlogs)
-#FN
حداکثر تعداد فیلترها (--advanced-maxfilters[=N])
-#h
اطلاعات نسخه (--version)
-#K
پویش ورودی استاندارد (اشکال‌زدایی) (--debug-scanstdin)
-#L
حداکثر تعداد پیوندها (-#L1000000) (--advanced-maxlinks[=N])
-#p
نمایش اطلاعات پیشرفت ناخوشایند (--advanced-progressinfo)
-#P
گرفتن نشانی وب (--catch-url)
-#T
تولید گزارش عملیات انتقال در هر دقیقه (--debug-xfrstats)
-#u
زمان انتظار (--advanced-wait[=N])
-#Z
تولید آمار نرخ انتقال در هر دقیقه (--debug-ratestats)

-%!
دور زدن محدودیت‌های امنیتی توکار که با هدف جلوگیری از سوءاستفاده از پهنای باند تعبیه شده‌اند (پهنای باند، اتصال‌های هم‌روند) (--disable-security-limits[=0])
نکته مهم: گزینه خطرناک، فقط مناسب افراد متخصص
با احتیاط کامل استفاده کنید

اجرای دستور سیستم پس از دریافت هر فایل ($0 نام فایل است: -V "rm \$0") (--userdef-cmd <param>)
-%W
استفاده از یک تابع کتابخانه خارجی به‌عنوان لفاف (-%W myfoo.so[,myparameters]) (--callback <param>)
رفتن به پس‌زمینه در هنگام تعلیق (y0 یعنی نرو) (--background-on-suspend[=0])

ساختار سایت (پیش‌فرض)
پرونده‌های HTML در web/، تصاویر/سایر فایل‌ها در web/images/
پرونده‌های HTML در web/HTML، تصاویر/سایر در web/images
پرونده‌های HTML در web/، تصاویر/سایر در web/
پرونده‌های HTML در web/، تصاویر/سایر در web/xxx، که در آن xxx پسوند فایل است (برای مثال، همه gifها در web/gif قرار می‌گیرند)
تصاویر/سایر در web/xxx و HTML در web/HTML
تمامی فایل‌ها در web/، با نام‌های تصادفی (ابزارک!)
ساختار سایت، بدون www.domain.xxx/
مشابه N1 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N2 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N3 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N4 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N5 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N99 به جز این‌که نام سایت جایگزین "web" می‌شود
مشابه N1 به جز این‌که دایرکتوری "web" وجود ندارد
مشابه N2 به جز این‌که دایرکتوری "web" وجود ندارد
مشابه N3 به جز این‌که دایرکتوری "web" وجود ندارد (گزینه تنظیم‌شده برای گزینه g)
مشابه N4 به جز این‌که دایرکتوری "web" وجود ندارد
مشابه N5 به جز این‌که دایرکتوری "web" وجود ندارد
مشابه N99 به جز این‌که دایرکتوری "web" وجود ندارد

-%n
نام فایل بدون نوع/پسوند فایل (مثال: image)
-%N
نام فایل، شامل نوع/پسوند فایل (مثال: image.gif)
-%t
نوع/پسوند فایل (مثال: gif)
-%p
مسیر [بدون اسلش پایانی] (مثال: /someimages)
-%h
نام میزبان (مثال: www.example.com)
-%M
چکیده MD5 نشانی وب (۱۲۸ بیت، ۳۲ بایت اسکی)
-%Q
چکیده MD5 رشته پرس‌وجو (۱۲۸ بیت، ۳۲ بایت اسکی)
-%k
رشته پرس‌وجوی کامل
-%r
نام پروتکل (مثال: http)
-%q
چکیده MD5 کوچک رشته پرس‌وجو (۱۶ بیت، ۴ بایت اسکی)
نسخه نام کوتاه '%s?' (مثال: %sN)
-%[param]
متغیر param در رشته پرس‌وجو
-%[param:before:after:empty:notfound]
استخراج پیشرفته متغیر

%[param:before:after:empty:notfound]
param : نام پارامتر
before : رشته‌ای که در صورت یافتن پارامتر به ابتدا اضافه می‌شود
after : رشته‌ای که در صورت یافتن پارامتر به انتها اضافه می‌شود
notfound : رشته جایگزین در صورتی که پارامتر پیدا نشود
empty : رشته جایگزین در صورتی که پارامتر خالی باشد
تمامی فیلدها، به جز فیلد نخست (نام پارامتر)، می‌توانند خالی باشند

foo.cgi?q=45 -> foo4B54.html?q=45 (شناسه URI نسبی، پیش‌فرض)
-> http://www.example.com/folder/foo.cgi?q=45 (نشانی URL مطلق) (--keep-links[=N])
-> /folder/foo.cgi?q=45 (شناسه URI مطلق)
-> foo.cgi?q=45 (نشانی URL اصلی)
-> http://www.example.com/folder/foo4B54.html?q=45 (نشانی URL پیشکار شفاف)

<URLs> *تهیه یک آینه از سایت(ها) (پیش‌فرض)
<URLs> دریافت فایل‌های مشخص‌شده، عدم جستجوی سایر نشانی‌های وب (-qg)
<text file> افزودن تمامی نشانی‌های وب موجود در این فایل متنی (-%L)
<URLs> آینه‌کردن تمامی پیوندها در صفحات سطح اول (-Y)
<URLs> آزمودن پیوندها در صفحات (-r1p0C0I0t)
<URLs> خزش در سایت(ها) برای آزمودن پیوندها: گزارش خطاها و هشدارها (-p0C0I0t)
<URLs> مشابه --spider
<URLs> تهیه یک آینه، اما فقط فایل‌های HTML دریافت می‌شوند (-p1)
به‌روزرسانی یک آینه، بدون تایید (-iC2)
ادامه دادن یک آینه‌سازی، بدون تایید (-iC1)
ایجاد یک پیشکار موقت برای ضبط یک نشانی وب یا نشانی ارسال فرم (POST)
پاک کردن حافظه موقت و فایل‌های گزارش
اجبار به درخواست‌های HTTP/1.0 (-%h)

0
عملیات آینه‌سازی تا انتها اجرا شد، یا به دلیل درخواست متوقف گردید: یک سیگنال، پوسته تعاملی، یا سقف انتقال تعیین‌شده با --max-time یا --max-size. رسیدن به سقف تعیین‌شده همان نتیجه درخواستی بوده است و نه یک شکست، بنابراین حتی اگر فایل گزارش آن را توقف اجباری بنامد، یک لغو نابهنگام تلقی نمی‌شود.
3
آینه‌سازی شروع شد اما موتور پیش از پایان کار متوقف گردید: پر شدن دیسک، شکست در نوشتن حافظه موقت، یا رسیدن جدول پیوندها به سقف -#L . برخلاف سقف زمان یا حجم، این سقف کارِ خواسته‌شده را نیمه‌کاره متوقف می‌کند نه این‌که آن را برآورده سازد؛ به همین دلیل این دو نوع محدودیتِ تعیین‌شده توسط کاربر به شکل متفاوتی گزارش می‌شوند. دلیل آن در فایل گزارش آمده است و آنچه پیش از توقف آینه‌سازی شده بود نگه‌داری می‌شود. این وضعیت خروج فرآیند است؛ وضعیت exit_xh خودِ موتور یک کانال جداگانه با مقادیر مختص به خود است، و این دو از یکدیگر تفکیک شده‌اند تا هیچ‌یک به جای دیگری برداشت نشود.
1, 255
دستور httrack آرگومان‌های خط فرمان را نپذیرفت، یا عملیات حافظه موقتی که درخواست کرده بود با شکست مواجه شد. هیچ آینه‌سازی اجرا نشد.

/etc/httrack.conf

فایل پیکربندی سراسری سیستم.

در صورتی استفاده می‌شود که در /etc/httrack.conf خط زیر را تعریف کرده باشید: path ~/websites/#

خطاها/هشدارها به‌طور پیش‌فرض در hts-log.txt یا در صورت مشخص شدن گزینه -v در خروجی خطای استاندارد (stderr) گزارش می‌شوند.

این‌ها محدودیت‌های اصلی HTTrack در حال حاضر هستند. توجه داشته باشید که ابزار دیگری نیز شناخته نشده است که این محدودیت‌ها را حل کرده باشد. - اسکریپت‌های متعددی که نام فایل‌های پیچیده تولید می‌کنند ممکن است توسط برنامه شناسایی نشوند (مثال: img.src='image'+a+Mobj.dst+'.gif') - پیوندهای Cgi-bin ممکن است در برخی موارد به‌درستی کار نکنند (به پارامترها نیاز دارند). برای اجتناب از آن‌ها: از فیلترهایی مانند -*cgi-bin* استفاده کنید

لطفاً اشکالات را به <bugs@httrack.com> گزارش دهید. یک مثال کامل و خودکفا ارائه دهید که امکان بازتولید اشکال را فراهم کند، و مشخص کنید از کدام نسخه httrack استفاده می‌کنید. فراموش نکنید که گزینه‌های استفاده‌شده، نسخه سیستم‌عامل و هرگونه اطلاعات دیگری را که لازم می‌دانید شرح دهید.

حق نشر (C) ۱۹۹۸-۲۰۲۶ متعلق به Xavier Roche و سایر مشارکت‌کنندگان است.

این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخه ۳ مجوز یا (به انتخاب خودتان) هر نسخه پس از آن، بازتوزیع کرده یا تغییر دهید.

این برنامه به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل‌فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید. در غیر این صورت، نشانی http://www.gnu.org/licenses را ببینید.

تازه‌ترین نسخه منتشرشده httrack را می‌توانید در نشانی زیر بیابید: https://www.httrack.com

Xavier Roche <roche@httrack.com>

مستندات HTML (به‌صورت آنلاین در https://www.httrack.com/html در دسترس است) حاوی اطلاعات دقیق‌تری است. لطفاً همچنین به httrack FAQ (به‌صورت آنلاین در https://www.httrack.com/html/faq.html در دسترس است) مراجعه کنید.

02 September 2026 httrack website copier