git-daemon - عبر الإنترنت في السحابة

برنامج:

اسم

git-daemon - خادم بسيط جدًا لمستودعات Git

موجز

طائرة نفاثة الخفي [--مطول] [--سجل النظام] [--تصدير الكل]
[--المهلة= ] [--init-timeout= ] [--max-connections= ]
[--المسارات الصارمة] [--المسار الأساسي= ] [--مسار أساسي مريح]
[--مسار المستخدم | --مسار المستخدم= ]
[--مسار محرف= ]
[--reuseaddr] [--فصل] [--pid-file= ]
[--تمكين= ] [--تعطيل= ]
[--السماح بالتجاوز= ] [--forbid-override= ]
[--الوصول هوك = ] [--[لا-]أخطاء إعلامية]
[--إنتد |
[--استمع= ] [--المنفذ= ]
[--المستخدم= [--المجموعة= ]]]
[ ...]

الوصف

برنامج TCP Git بسيط جدًا يستمع عادةً على المنفذ "DEFAULT_GIT_PORT" المعروف أيضًا باسم 9418.
إنه ينتظر اتصالاً يطلب الخدمة، وسيخدم تلك الخدمة إذا كانت كذلك
تمكين.

إنه يتحقق من أن الدليل يحتوي على الملف السحري "git-daemon-export-ok"، وسيفعل ذلك
رفض تصدير أي دليل Git لم يتم تحديده بشكل صريح للتصدير بهذه الطريقة
(ما لم يكن --تصدير الكل تم تحديد المعلمة). إذا قمت بتمرير بعض مسارات الدليل كـ طائرة نفاثة
الخفي الوسائط، يمكنك تقييد العروض بشكل أكبر على القائمة البيضاء التي تتألف من تلك.

بشكل افتراضي، يتم تمكين خدمة تحميل الحزمة فقط، والتي تخدم طائرة نفاثة أحضر حزمة و طائرة نفاثة
ليرة سورية عن بعد العملاء، والتي يتم استدعاؤها من طائرة نفاثة جلب, طائرة نفاثة سحبو طائرة نفاثة استنساخ.

يعد هذا مناسبًا بشكل مثالي لتحديثات القراءة فقط، أي السحب من مستودعات Git.

أرشيف التحميل موجود أيضًا للخدمة طائرة نفاثة أرشيف.

OPTIONS

- مسارات صارمة
قم بمطابقة المسارات تمامًا (أي لا تسمح بـ "/foo/repo" عندما يكون المسار الحقيقي كذلك
"/foo/repo.git" أو "/foo/repo/.git") ولا تقم بإنشاء مسارات متعلقة بالمستخدم. طائرة نفاثة الخفي
سيرفض البدء عند تمكين هذا الخيار وعدم تحديد قائمة بيضاء.

--base-path=
إعادة تعيين كافة طلبات المسار بالنسبة للمسار المحدد. هذا نوع من "Git root"
- اذا ركضت طائرة نفاثة الخفي مع --base-path=/srv/git على example.com، ثم إذا قمت بذلك لاحقًا
حاول أن تسحب جيت://example.com/hello.git, طائرة نفاثة الخفي سوف يفسر المسار كما
/srv/git/hello.git.

--قاعدة المسار استرخاء
إذا تم تمكين --base-path وفشل بحث الريبو، باستخدام هذا الخيار طائرة نفاثة الخفي سوف
محاولة البحث دون بادئة المسار الأساسي. وهذا مفيد للتبديل إلى
- استخدام المسار الأساسي، مع السماح بالمسارات القديمة.

--interpolated-path=
لدعم الاستضافة الافتراضية، يمكن استخدام قالب مسار محرف ديناميكيًا
بناء مسارات بديلة. يدعم القالب %H لاسم المضيف الهدف كـ
يتم توفيرها من قبل العميل ولكن يتم تحويلها إلى أحرف صغيرة بالكامل، %CH لاسم المضيف الأساسي،
%IP لعنوان IP الخاص بالخادم، و%P لرقم المنفذ، و%D للمسار المطلق
من المستودع المسمى. بعد الاستيفاء، يتم التحقق من صحة المسار مقابل
القائمة البيضاء للدليل.

--تصدير الكل
السماح بالسحب من جميع الدلائل التي تشبه مستودعات Git (التي تحتوي على ملحق الأجسام
و الحكام الدلائل الفرعية)، حتى لو لم يكن لديهم git-daemon-export-ok ملف.

- inetd
اجعل الخادم يعمل كخدمة inetd. يعني --syslog. غير متوافق مع --فصل،
--port، --listen، --user و--group options.

--استمع=
استمع على عنوان IP أو اسم مضيف محدد. يمكن أن تكون عناوين IP إما IPv4
العنوان أو عنوان IPv6 إذا كان مدعومًا. إذا لم يكن IPv6 مدعومًا، إذن
--listen=hostname غير مدعوم أيضًا ويجب أن يُعطى --listen عنوان IPv4.
يمكن إعطاؤه أكثر من مرة. غير متوافق مع - inetd الخيار.

--المنفذ=
الاستماع على منفذ بديل. غير متوافق مع - inetd الخيار.

--init-timeout=
المهلة (بالثواني) بين لحظة إنشاء الاتصال والعميل
يتم تلقي الطلب (عادة ما تكون قيمة منخفضة إلى حد ما، حيث يجب أن يكون ذلك في الأساس
مباشر).

- المهلة =
المهلة (بالثواني) لطلبات فرعية محددة من العميل. وهذا يشمل الوقت الذي يستغرقه
حتى يتمكن الخادم من معالجة الطلب الفرعي والوقت المستغرق في انتظار الطلب التالي
طلب العميل.

--max-connections=
الحد الأقصى لعدد العملاء المتزامنين، الافتراضي هو 32. اضبطه على صفر بلا حدود.

- سجل
قم بتسجيل الدخول إلى سجل النظام بدلاً من stderr. لاحظ أن هذا الخيار لا يعني ضمنيًا --verbose
افتراضيًا، سيتم تسجيل حالات الخطأ فقط.

--مسار المستخدم، --مسار المستخدم =
السماح باستخدام تدوين المستخدم في الطلبات. عند التحديد بدون معلمة،
تعتبر طلبات git://host/~alice/foo بمثابة طلب للوصول فو المستودع في
الدليل الرئيسي للمستخدم أليس. إذا تم تحديد --user-path=path، فسيتم تقديم نفس الطلب
يتم اعتباره طلبًا للوصول إلى مستودع المسار/foo في الدليل الرئيسي للمستخدم
أليس.

- الإسراف
تسجيل تفاصيل حول الاتصالات الواردة والملفات المطلوبة.

--reuseaddr
استخدم SO_REUSEADDR عند ربط مقبس الاستماع. وهذا يسمح للخادم بإعادة التشغيل
دون انتظار انتهاء مهلة الاتصالات القديمة.

--فصل
انفصل عن القشرة. يعني --syslog.

--pid-file=
احفظ معرف العملية في ملف. يتم تجاهله عند تشغيل البرنامج الخفي ضمن --inetd.

--المستخدم= --المجموعة=
قم بتغيير uid وgid الخاصين بالبرنامج الخفي قبل الدخول إلى حلقة الخدمة. عندما يكون --user فقط
نظرا بدون --group، يتم استخدام معرف المجموعة الأساسي للمستخدم. قيم ال
يتم إعطاء الخيار ل com.getpwnam(3) و غيتغرنام(3) والمعرفات الرقمية غير مدعومة.

يعد إعطاء هذه الخيارات خطأً عند استخدامه مع --inetd; استخدام مرفق آينت
الشيطان لتحقيق نفس الشيء قبل التفريخ طائرة نفاثة الخفي إذا لزم الأمر.

مثل العديد من البرامج التي تقوم بتبديل معرف المستخدم، لا يقوم البرنامج الخفي بإعادة ضبط البيئة
المتغيرات مثل $HOME عند تشغيل برامج git، على سبيل المثال حزمة التحميل وتلقي الحزمة.
عند استخدام هذا الخيار، قد ترغب أيضًا في تعيين وتصدير HOME للإشارة إلى المنزل
دليل قبل بدء البرنامج الخفي، وتأكد من أي تكوين لـ Git
الملفات الموجودة في هذا الدليل قابلة للقراءة بواسطة .

--تمكين= ، --تعطيل=
تمكين/تعطيل الخدمة على مستوى الموقع بشكل افتراضي. لاحظ أن الخدمة معطلة
لا يزال من الممكن تمكين مستوى الموقع لكل مستودع إذا تم وضع علامة "قابل للتجاوز" عليه و
يتيح المستودع الخدمة بعنصر التكوين.

--السماح بالتجاوز = ، --forbid-override=
السماح/منع تجاوز الإعداد الافتراضي على مستوى الموقع مع التكوين لكل مستودع. بواسطة
بشكل افتراضي، قد يتم تجاوز كافة الخدمات.

--[no-]أخطاء إعلامية
عند تشغيل الأخطاء المعلوماتية، سيقوم git-daemon بالإبلاغ عن المزيد من الأخطاء المطولّة
العميل، مع التمييز بين الشروط مثل "لا يوجد مثل هذا المستودع" و"المستودع لا".
تم تصديرها". يعد هذا أكثر ملاءمة للعملاء، ولكنه قد يؤدي إلى تسرب معلومات حول
وجود مستودعات غير مصدرة. عندما لا يتم تمكين الأخطاء الإعلامية، كل شيء
تقرير الأخطاء "تم رفض الوصول" إلى العميل. الافتراضي هو --no-informative-errors.

--access-hook=
في كل مرة يتصل فيها العميل، قم أولاً بتشغيل أمر خارجي محدد بواسطة
مع اسم الخدمة (على سبيل المثال "حزمة التحميل")، والمسار إلى المستودع، واسم المضيف (%H)،
اسم المضيف الأساسي (%CH)، وعنوان IP (%IP)، ومنفذ TCP (%P) كسطر أوامر خاص به
الحجج. يمكن للأمر الخارجي أن يقرر رفض الخدمة عن طريق الخروج باستخدام ملف
حالة غير صفرية (أو السماح بها عن طريق الخروج بحالة صفر). ويمكن أن ننظر أيضا
متغيرات البيئة $REMOTE_ADDR و$REMOTE_PORT للتعرف على الطالب
عند اتخاذ هذا القرار.

يمكن للأمر الخارجي أن يكتب بشكل اختياري سطرًا واحدًا إلى مخرجاته القياسية
يتم إرسالها إلى مقدم الطلب كرسالة خطأ عند رفض الخدمة.


دليل لإضافته إلى القائمة البيضاء للأدلة المسموح بها. ما لم تكن --strict-paths كذلك
المحدد سيتضمن هذا أيضًا الدلائل الفرعية لكل دليل مسمى.

الخدمات

يمكن تمكين/تعطيل هذه الخدمات عالميًا باستخدام خيارات سطر الأوامر الخاصة بهذا
يأمر. إذا كان التحكم الدقيق مطلوبًا (على سبيل المثال، السماح طائرة نفاثة أرشيف ليتم تشغيلها ضد
فقط في عدد قليل من المستودعات المحددة التي يخدمها البرنامج الخفي)، التكوين لكل مستودع
يمكن استخدام الملف لتمكينها أو تعطيلها.

تحميل حزمة
هذا يخدم طائرة نفاثة أحضر حزمة و طائرة نفاثة ليرة سورية عن بعد عملاء. يتم تمكينه بشكل افتراضي، ولكن أ
يمكن للمستودع تعطيله عن طريق ضبط عنصر تكوين daemon.uploadpack على false.

تحميل أرشيف
هذا يخدم طائرة نفاثة أرشيف --التحكم عن بعد. يتم تعطيله افتراضيًا، لكن المستودع يمكنه ذلك
قم بتمكينه عن طريق ضبط عنصر تكوين daemon.uploadarch على true.

استلام الحزمة
هذا يخدم طائرة نفاثة إرسال حزمة العملاء، مما يسمح بالدفع المجهول. تم تعطيل بشكل افتراضي،
كما هناك لا المصادقة في البروتوكول (وبعبارة أخرى، يمكن لأي شخص دفع
أي شيء في المستودع، بما في ذلك إزالة المراجع). هذا مخصص فقط ل
إعداد شبكة LAN مغلقة حيث يكون الجميع ودودين. يمكن تفعيل هذه الخدمة عن طريق الإعداد
عنصر تكوين daemon.receivepack إلى صحيح.

أمثلة

نفترض ما يلي في / الخ / خدمات

$ جريب 9418 / الخ / خدمات
git 9418/tcp # نظام التحكم في إصدار Git

طائرة نفاثة الخفي كخادم inetd
للإعداد طائرة نفاثة الخفي كخدمة inetd التي تتعامل مع أي مستودع ضمن
مجموعة الدلائل المدرجة في القائمة البيضاء، /pub/foo و/pub/bar، ضع إدخالاً مثل
المتابعة إلى /etc/inetd كلها في سطر واحد:

بوابة تيار TCP الآن لا أحد / usr / bin / git
git daemon --inetd --verbose --export-all
/حانة/فو /حانة/بار

طائرة نفاثة الخفي كخادم inetd للمضيفين الظاهريين
للإعداد طائرة نفاثة الخفي كخدمة inetd التي تتعامل مع المستودعات لمختلف
المضيفون الظاهريون، www.example.com وwww.example.org، ضع إدخالاً كما يلي
إلى /etc/inetd الكل في سطر واحد:

بوابة تيار TCP الآن لا أحد / 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، رابط رمزي من
يمكن أيضًا إنشاء /software في المستودع الافتراضي المناسب.

طائرة نفاثة الخفي كبرنامج خفي عادي للمضيفين الظاهريين
للإعداد طائرة نفاثة الخفي كخدمة عادية غير مخصصة تتعامل مع المستودعات
مضيفين افتراضيين متعددين بناءً على عناوين IP الخاصة بهم، ابدأ تشغيل البرنامج الخفي على النحو التالي:

git daemon --verbose --export-all
--interpolated-path=/pub/%IP/%D
/pub/192.168.1.200/software
/pub/10.10.220.23/software

في هذا المثال، سيحتوي الدليل /pub على مستوى الجذر على دليل فرعي لكل منهما
عنوان IP للمضيف الظاهري مدعوم. لا يزال من الممكن الوصول إلى المستودعات عن طريق اسم المضيف
على الرغم من ذلك، على افتراض أنها تتوافق مع عناوين IP هذه.

تمكين/تعطيل الخدمات بشكل انتقائي لكل مستودع
للتمكين طائرة نفاثة أرشيف --التحكم عن بعد وتعطيله طائرة نفاثة جلب مقابل مستودع، لديك
التالي في ملف التكوين الموجود في المستودع (هذا هو الملف التكوين قرب
هيد, الحكام و الأجسام).

[شيطان]
تحميل الحزمة = خطأ
uploadarch = صحيح

البيئة

طائرة نفاثة الخفي سيتم تعيين REMOTE_ADDR على عنوان IP الخاص بالعميل المتصل به، إذا
عنوان IP متاح. سيكون REMOTE_ADDR متاحًا في بيئة الخطافات
يتم استدعاؤه عند تنفيذ الخدمات.

GIT

جزء من طائرة نفاثة(1) جناح

استخدم git-daemon عبر الإنترنت باستخدام خدمات onworks.net