git-daemon - آنلاین در ابر

برنامه:

نام

git-daemon - یک سرور واقعا ساده برای مخازن Git

خلاصه

دستگاه گوارش روح پلید [--کلمه] [--syslog] [--export-all]
[--timeout= ] [--init-timeout= ] [--max-connections= ]
[--strict-paths] [--base-path= ] [--base-path-relaxed]
[--user-path | --user-path= ]
[--interpolated-path= ]
[--reuseaddr] [-- جدا کردن] [--pid-file= ]
[--فعال کردن= ] [--disable= ]
[--allow-override= ] [--forbid-override= ]
[--access-hook= ] [--[بدون-]خطاهای اطلاعاتی]
[--inetd |
[--گوش دادن= ] [--port= ]
[--user= [--گروه= ]]]
[ ...]

شرح

یک دیمون بسیار ساده TCP Git که معمولاً در پورت "DEFAULT_GIT_PORT" معروف به 9418 گوش می دهد.
منتظر یک اتصال می ماند و درخواست سرویس می کند و در صورت وجود، آن سرویس را ارائه می دهد
فعال شده است

تأیید می کند که دایرکتوری دارای فایل جادویی "git-daemon-export-ok" است و
از صادرات هر دایرکتوری Git که صراحتاً برای صادرات به این روش علامت گذاری نشده است خودداری کنید
(مگر اینکه --صادرات-همه پارامتر مشخص شده است). اگر برخی از مسیرهای دایرکتوری را به عنوان عبور دهید دستگاه گوارش
روح پلید آرگومان‌ها، می‌توانید پیشنهادات را بیشتر به لیست سفید متشکل از آن‌ها محدود کنید.

به‌طور پیش‌فرض، فقط سرویس بسته آپلود فعال است که خدمات می‌دهد دستگاه گوارش واکشی بسته و دستگاه گوارش
ls-remote مشتریانی که از آنها فراخوانی می شوند دستگاه گوارش رفتن و آوردن, دستگاه گوارش کشیدنو دستگاه گوارش کلون کردن.

این به‌طور ایده‌آل برای به‌روزرسانی‌های فقط خواندنی، یعنی کشیدن از مخازن Git مناسب است.

یک آپلود-آرشیو نیز برای خدمت وجود دارد دستگاه گوارش بایگانی.

OPTIONS

-- مسیرهای سخت
مسیرها را دقیقاً مطابقت دهید (یعنی اجازه ندهید "/foo/repo" زمانی که مسیر واقعی است
"/foo/repo.git" یا "/foo/repo/.git") و مسیرهای مربوط به کاربر را انجام ندهید. دستگاه گوارش روح پلید
زمانی که این گزینه فعال باشد و هیچ لیست سفیدی مشخص نشده باشد، شروع به کار نخواهد کرد.

--base-path=
همه درخواست‌های مسیر را نسبت به مسیر داده شده مجدداً ترسیم کنید. این یک نوع "روت Git" است
- اگر بدوید دستگاه گوارش روح پلید با --base-path=/srv/git در example.com، سپس اگر بعداً
سعی کنید بکشید git://example.com/hello.git, دستگاه گوارش روح پلید مسیر را به عنوان تفسیر خواهد کرد
/srv/git/hello.git.

---پایه-مسیر آرام
اگر مسیر --base فعال باشد و جستجوی مخزن ناموفق باشد، با این گزینه دستگاه گوارش روح پلید اراده
سعی کنید بدون پیشوند مسیر پایه جستجو کنید. این برای تغییر به مفید است
- استفاده از مسیر پایه، در حالی که هنوز مسیرهای قدیمی را مجاز می کند.

--interpolated-path=
برای پشتیبانی از میزبانی مجازی، می توان از یک الگوی مسیر درونیابی شده به صورت پویا استفاده کرد
مسیرهای جایگزین بسازید الگو از %H برای نام میزبان هدف به عنوان پشتیبانی می کند
ارائه شده توسط مشتری، اما به تمام حروف کوچک، %CH برای نام میزبان متعارف تبدیل شده است،
%IP برای آدرس IP سرور، %P برای شماره پورت و %D برای مسیر مطلق
از مخزن نام برده شده پس از درونیابی، مسیر در مقابل اعتبارسنجی می شود
فهرست سفید دایرکتوری

--صادرات-همه
کشیدن از همه دایرکتوری هایی که شبیه مخازن Git هستند (دارای اشیاء
و رفر زیر شاخه ها)، حتی اگر آنها را نداشته باشند git-daemon-export-ok فایل.

--inetd
سرور را به عنوان یک سرویس inetd اجرا کنید. به معنای --syslog است. ناسازگار با - جدا کردن،
گزینه های --port، --listen، --user و --group.

--گوش دادن=
به یک آدرس IP یا نام میزبان خاص گوش دهید. آدرس های IP می توانند IPv4 باشند
آدرس یا آدرس IPv6 در صورت پشتیبانی. اگر IPv6 پشتیبانی نمی شود، پس
--listen=hostname نیز پشتیبانی نمی شود و --listen باید یک آدرس IPv4 داده شود.
می توان بیش از یک بار داد. ناسازگار با --inetd گزینه.

--پورت=
در یک پورت جایگزین گوش دهید. ناسازگار با --inetd گزینه.

--init-timeout=
فاصله زمانی بین لحظه برقراری ارتباط و مشتری (بر حسب ثانیه).
درخواست دریافت می شود (معمولاً یک مقدار نسبتاً کم است، زیرا اساساً باید باشد
فوری).

--تایم اوت=
مهلت زمانی (در ثانیه) برای درخواست های فرعی مشتری خاص. این شامل زمان لازم است
برای سرور برای پردازش درخواست فرعی و زمان صرف شده در انتظار درخواست بعدی
درخواست مشتری

--max-connections=
حداکثر تعداد کلاینت‌های همزمان، پیش‌فرض روی 32 است. بدون محدودیت، آن را صفر کنید.

--syslog
به جای stderr به syslog وارد شوید. توجه داشته باشید که این گزینه به معنای ---verbose نیست، بنابراین
به طور پیش فرض فقط شرایط خطا ثبت می شود.

--user-path، --user-path=
اجازه استفاده از ~user notation در درخواست ها را بدهید. وقتی بدون پارامتر مشخص شد،
درخواست برای git://host/~alice/foo به عنوان درخواست دسترسی در نظر گرفته می شود فو مخزن در
فهرست اصلی کاربر آلیس اگر --user-path=path مشخص شده باشد، همان درخواست
به عنوان یک درخواست برای دسترسی به مخزن path/foo در فهرست اصلی کاربر در نظر گرفته می شود
آلیس

-- پرحرف
جزئیات مربوط به اتصالات ورودی و فایل های درخواستی را ثبت کنید.

-- reuseaddr
هنگام اتصال سوکت گوش دادن از SO_REUSEADDR استفاده کنید. این به سرور اجازه راه اندازی مجدد می دهد
بدون اینکه منتظر بمانید تا اتصالات قدیمی تمام شود.

-- جدا کردن
از پوسته جدا شود. به معنای --syslog است.

--pid-file=
شناسه فرآیند را در آن ذخیره کنید پرونده. هنگامی که دیمون تحت --inetd اجرا می شود نادیده گرفته می شود.

--user= ، --گروه=
قبل از ورود به حلقه سرویس، uid و gid دیمون را تغییر دهید. زمانی که فقط --user باشد
بدون --group داده می شود، شناسه گروه اولیه برای کاربر استفاده می شود. ارزش های
گزینه داده می شود getpwnam(3) و getgrnam(3) و شناسه های عددی پشتیبانی نمی شوند.

دادن این گزینه ها هنگام استفاده با --inetd یک خطا است. از امکانات inet استفاده کنید
شبح برای رسیدن به همان قبل از تخم ریزی دستگاه گوارش روح پلید در صورت نیاز.

مانند بسیاری از برنامه هایی که شناسه کاربر را تغییر می دهند، دیمون محیط را بازنشانی نمی کند
متغیرهایی مانند $HOME هنگامی که برنامه های git را اجرا می کند، به عنوان مثال آپلود بسته و دریافت بسته.
هنگام استفاده از این گزینه، ممکن است بخواهید HOME را برای اشاره به خانه تنظیم و صادر کنید
دایرکتوری از قبل از شروع Daemon، و از تنظیمات Git مطمئن شوید
فایل های موجود در آن دایرکتوری قابل خواندن هستند .

--enable= ، --disable=
فعال/غیرفعال کردن سرویس در سراسر سایت به صورت پیش فرض. توجه داشته باشید که یک سرویس غیرفعال است
درصورتی‌که به‌عنوان یک مخزن علامت‌گذاری شده باشد، می‌توان آن را در سراسر سایت فعال کرد
مخزن سرویس را با یک آیتم پیکربندی فعال می کند.

--allow-override= ، --forbid-override=
اجازه/منع لغو پیش‌فرض در سراسر سایت با پیکربندی هر مخزن. توسط
به طور پیش فرض، همه سرویس ها ممکن است لغو شوند.

--[no-]informative-errors
وقتی خطاهای اطلاعاتی روشن هستند، git-daemon خطاهای پرمخاطب بیشتری را به آن گزارش می دهد
کلاینت، شرایطی مانند "هیچ مخزن وجود ندارد" را از "مخزن نه" متمایز می کند
صادر می شود". این برای مشتریان راحت تر است، اما ممکن است اطلاعاتی در مورد آن به بیرون درز کند
وجود مخازن صادر نشده وقتی خطاهای اطلاعاتی فعال نیستند، همه
خطاها "دسترسی ممنوع" را به مشتری گزارش می دهند. پیش فرض --no-informative-errors است.

--access-hook=
هر بار که یک کلاینت متصل می شود، ابتدا یک دستور خارجی که توسط آن مشخص شده است را اجرا کنید
با نام سرویس (به عنوان مثال "upload-pack")، مسیر مخزن، نام میزبان (%H)،
نام میزبان متعارف (% CH)، آدرس IP (% IP) و پورت TCP (% P) به عنوان خط فرمان آن
استدلال ها فرمان خارجی می تواند با خروج از a تصمیم به رد سرویس بگیرد
وضعیت غیر صفر (یا اجازه دادن به آن با خروج با وضعیت صفر). همچنین می تواند نگاه کند
متغیرهای محیطی $REMOTE_ADDR و $REMOTE_PORT برای اطلاع از درخواست کننده
هنگام گرفتن این تصمیم

دستور خارجی می تواند به صورت اختیاری یک خط را در خروجی استاندارد خود بنویسد
هنگامی که درخواست کننده سرویس را رد می کند به عنوان یک پیام خطا برای درخواست کننده ارسال می شود.


دایرکتوری برای افزودن به لیست سفید دایرکتوری های مجاز. مگر اینکه --strict-paths باشد
مشخص شده است که این شامل زیر شاخه های هر فهرست نامگذاری شده نیز می شود.

خدمات

این سرویس‌ها را می‌توان با استفاده از گزینه‌های خط فرمان به صورت سراسری فعال/غیرفعال کرد
فرمان اگر کنترل با دانه بندی ریزتر مورد نظر است (مثلاً اجازه دهید دستگاه گوارش بایگانی علیه اجرا شود
فقط در چند مخزن منتخب، شبح خدمت می کند)، پیکربندی هر مخزن
فایل را می توان برای فعال یا غیرفعال کردن آنها استفاده کرد.

آپلود بسته
این خدمت می کند دستگاه گوارش واکشی بسته و دستگاه گوارش ls-remote مشتریان به طور پیش فرض فعال است، اما a
مخزن می تواند آن را با تنظیم آیتم پیکربندی daemon.uploadpack روی false غیرفعال کند.

آپلود-آرشیو
این خدمت می کند دستگاه گوارش بایگانی --از راه دور. به طور پیش فرض غیرفعال است، اما یک مخزن می تواند
آن را با تنظیم مورد پیکربندی daemon.uploadarch روی true فعال کنید.

بسته دریافتی
این خدمت می کند دستگاه گوارش ارسال بسته مشتریان، اجازه فشار ناشناس را می دهد. آن به صورت پیشفرض از کار افتاده،
همانطور که وجود دارد نه احراز هویت در پروتکل (به عبارت دیگر، هر کسی می تواند فشار دهد
هر چیزی در مخزن، از جمله حذف refs). این فقط برای a
تنظیمات LAN بسته که در آن همه دوستانه هستند. این سرویس را می توان با تنظیم فعال کرد
مورد پیکربندی daemon.receivepack به true.

مثال ها

ما موارد زیر را در فرض می کنیم / و غیره / خدمات

grep 9418 دلار / و غیره / خدمات
git 9418/tcp # سیستم کنترل نسخه Git

دستگاه گوارش روح پلید به عنوان سرور inetd
برای راه اندازی دستگاه گوارش روح پلید به عنوان یک سرویس inetd که هر مخزن زیر را مدیریت می کند
مجموعه ای از فهرست های سفید، /pub/foo و /pub/bar، یک ورودی مانند قرار دهید
همه را در یک خط به /etc/inetd دنبال کنید:

git stream tcp nowait nobody /usr/bin/git
git daemon --inetd --verbose --export-all
/pub/foo /pub/bar

دستگاه گوارش روح پلید به عنوان سرور inetd برای هاست های مجازی
برای راه اندازی دستگاه گوارش روح پلید به عنوان یک سرویس inetd که مخازن مختلف را مدیریت می کند
میزبان های مجازی، www.example.com و www.example.org، یک ورودی مانند زیر قرار دهید
به /etc/inetd همه در یک خط:

git stream tcp nowait nobody /usr/bin/git
git daemon --inetd --verbose --export-all
--interpolated-path=/pub/%H%D
/pub/www.example.org/software
/pub/www.example.com/software
/نرم افزار

در این مثال، دایرکتوری /pub در سطح ریشه شامل یک زیر شاخه برای هر کدام خواهد بود
نام میزبان مجازی پشتیبانی می شود. علاوه بر این، هر دو میزبان مخازن را به سادگی تبلیغ می کنند
git://www.example.com/software/repo.git. برای مشتریان قبل از 1.4.0، یک پیوند نمادین از
نرم افزار / در مخزن پیش فرض مناسب نیز می تواند ساخته شود.

دستگاه گوارش روح پلید به عنوان دیمون معمولی برای میزبان های مجازی
برای راه اندازی دستگاه گوارش روح پلید به‌عنوان یک سرویس معمولی و غیرمجاز که مخازن را مدیریت می‌کند
چندین میزبان مجازی بر اساس آدرس IP آنها، دیمون را به این صورت شروع کنید:

git daemon --verbose --export-all
--interpolated-path=/pub/%IP/%D
/pub/192.168.1.200/نرم افزار
/pub/10.10.220.23/نرم افزار

در این مثال، دایرکتوری /pub در سطح ریشه شامل یک زیر شاخه برای هر کدام خواهد بود
آدرس IP میزبان مجازی پشتیبانی می شود. هنوز هم می توان با نام میزبان به مخازن دسترسی داشت
با این حال، با فرض اینکه آنها با این آدرس های IP مطابقت دارند.

به طور انتخابی خدمات در هر مخزن را فعال/غیرفعال کنید
برای فعال کردن دستگاه گوارش بایگانی --از راه دور و غیرفعال کنید دستگاه گوارش رفتن و آوردن در مقابل یک مخزن، داشته باشید
در فایل پیکربندی موجود در مخزن (که همان فایل است پیکربندی در کنار
HEAD, رفر و اشیاء).

[اهریمن، دیو]
آپلود پک = نادرست
آپلودارچ = درست است

محیط زیست

دستگاه گوارش روح پلید REMOTE_ADDR را به آدرس IP مشتری که به آن متصل شده است تنظیم می کند، اگر
آدرس IP موجود است. REMOTE_ADDR در محیط قلاب ها در دسترس خواهد بود
هنگام انجام خدمات تماس گرفته می شود.

GIT

بخشی از دستگاه گوارش(1) سوئیت

از git-daemon به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید