<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpf;">
  <!ENTITY package "kdenetwork">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Russian "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

  <bookinfo>

    <title
>Руководство &kpf;</title>

    <authorgroup>

      <author
><firstname
>Rik</firstname
> <surname
>Hemsley</surname
> <affiliation
> <address
><email
>rik@kde.org</email
></address>
        </affiliation>
      </author>

      <othercredit role="translator"
><firstname
>Олег</firstname
><surname
>Баталов</surname
><affiliation
><address
><email
>olegbatalov@mail.ru</email
></address
></affiliation
><contrib
>Перевод на русский язык</contrib
></othercredit
> 

    </authorgroup>

    <copyright>
      <year
>2002</year>
      <holder
>Rik Hemsley</holder>
    </copyright>

    <legalnotice
>&FDLNotice;</legalnotice>

    <date
>2003-09-30</date>
    <releaseinfo
>1.0.1</releaseinfo>

    <abstract>
      <para
>&kpf; позволяет вам предоставлять доступ к файлам по сети. </para>
    </abstract>

    <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>общие</keyword>
      <keyword
>файловый сервер</keyword>
      <keyword
>HTTP</keyword>
    </keywordset>

  </bookinfo>

  <chapter id="introduction">

    <title
>Введение</title>

    <para
>&kpf; обеспечивает простое предоставление доступа к файлом по протоколу &HTTP; (протокол передачи гипертекста), который используется сайтами для предоставления данных вашему веб-броузеру. &kpf; является исключительно публичный файловый сервер. Это значить что не существует никаких ограничений на доступ к предоставленным файлам. В не зависимости от того что вы предоставляете - это становится доступно любому. </para>

    <para
>&kpf; разработан для возможности предоставления файлов друзьям, но не как полноценный веб-сервер типа <application
>Apache</application
>. &kpf; прежде всего был задуман как способ предоставления файлов другим при беседах в <acronym
>IRC</acronym
> (Internet Relay Chat, или <quote
>команд для разговора</quote
>.) </para>

    <para
>Обычное использование: &kpf; устанавливает обслуживание файлов в каталоге <filename class="directory"
>public_html</filename
> вашего домашнего каталога. Когда вы хотите сделать файл доступным некоторым собеседникам, с которыми вы общаетесь. Вместо того, чтобы посылать его каждому по почте как вложение (некоторые могут в нём не заинтересованы), вы копируйте его в каталог <filename class="directory"
>public_html</filename
> и объявляете что файл доступен по адресу http://www.mymachine.net:8001/thefile </para>

  </chapter>

  <chapter id="using-kpf">

    <title
>Использование &kpf;</title>

    <sect1 id="kpf-basics">

      <title
>Основы &kpf;</title>

      <para
>&kpf; выполняется в &kicker; как аплет. Поэтому занимает немного места на экране и его статус всегда виден. Для запуска аплета &kpf; щёлкните <mousebutton
>правой</mousebutton
> кнопки мыши на &kicker; и выберите  <menuchoice
> <guisubmenu
> Добавить</guisubmenu
> <guisubmenu
>Аплет</guisubmenu
> <guimenuitem
>Файловый сервер</guimenuitem
></menuchoice
>. </para>

      <para
>&kpf; использует понятие общедоступных каталогов. Вы можете выбрать один или несколько каталогов чтобы сделать их общедоступными, и все файлы в этих каталогах (и всех подкаталогах) будут предоставлены. </para>

      <para
>Будьте чрезвычайно осторожны с каталогами, которые вы предоставляете. Все файлы в каталоге и его подкаталогах, включая <quote
>скрытые</quote
>  (<quote
>dotfiles</quote
>),станут доступны всему миру, так что будьте внимательны, и не предоставляйте конфиденциальную информацию типа паролей, ключей шифрования, адресную книгу, внутренние документы вашей организации, &etc;. </para>

      <para
>Когда &kpf; выполняется, вы можете видеть квадратный аплет с тонким утопающим бордюром и пиктограммой изображающей <guiicon
>воздушный шар</guiicon
>. Шар виден когда никакие каталоги не предоставлены. </para>

      <para
>Чтобы предоставить каталог, щёлкните <mousebutton
>правой </mousebutton
> кнопкой мыши на пиктограмме и появится контекстное меню с одним пунктом, <guimenuitem
>Новый сервер...</guimenuitem
>. Выбор этого пункта вызовет <quote
>мастера</quote
>, который задаст вам несколько простых вопросов. Завершение ответов на них установит каталог как предоставленный. </para>

      <para
>Существует и альтернатива использованию аплета, когда вы ходите предоставить каталог: &kpf; интегрирован в  &konqueror;. </para>

      <para
>В &konqueror; откройте и отобразите каталог, щёлкните <mousebutton
>правой</mousebutton
> кнопкой мыши и откройте диалог <quote
>Свойства </quote
>. При установленном &kpf; в этом диалоге добавляется вкладка <guilabel
>Совместный доступ к файлам</guilabel
>. Вам будет предложено запустить &kpf; если он ещё не выполняется. Нажатие кнопки <guibutton
>Ok</guibutton
> пошлёт аплету &kpf; сигнал, добавляющий новый совместный ресурс. </para>

    </sect1>

  </chapter>

  <chapter id="share-config">

    <title
>Настройка предоставления</title>

    <sect1 id="listen-port">

      <title
>Порт</title>

      <para
>Для каждого предоставленного каталога, &kpf; открывает новый <quote
>порт</quote
>, который является числовым номером идентифицирующим сетевой сервис. Когда кто-либо использует программу (&eg;  веб-броузер) для подключения к компьютеру, од обращается к службе, по указанному адресу компьютера и <quote
>порту</quote
>, на котором выполняется эта служба. </para>

      <para
>Концепция <quote
>портов</quote
> позволяет одному компьютеру предоставлять несколько сетевых сервисов. Сервисы, которыми вы пользуетесь каждый день включая  &HTTP; Веб, обычно подключённым к порту 80, <acronym
>SMTP</acronym
> (отправка почты), обычно порт 25, и POP3 (получение почты), обычно порт 110. </para>

      <para
>В основном, когда вы подключаетесь к сетевому сервису, вам нет необходимости указывать <quote
>порт</quote
>. Это потому что порты стандартизированы, так что любой, кто соединиться с портом 80 компьютера в сети ожидает найти сервер &HTTP; (Веб). </para>

      <para
>&kpf; не является <quote
>стандартной службой</quote
>, так что для порта по умолчанию был выбран 8001. </para>

      <para
>Второй каталог, который вы предоставляете в совместное использование, будет доступен через порт 8002, и номер порта будет увеличиваться при создании каждого нового общего каталога. </para>

      <para
>Вы свободны выбирать порты для предоставления ресурсов в некоторых пределах, </para>

      <para
>Обычно порты ниже 1024 зарезервированы для <quote
>системных</quote
> сервисов, &ie; под управлением администратора компьютера, поэтому попытка использование порта ниже 1024 просто не будет работать. </para>

      <para
>&kpf; попытается предупредить вас, когда не сможет <quote
>использовать</quote
> к порт. При этом отображается пиктограмма <guiicon
>повреждённое соединение</guiicon
> в левой верхней части аплета. &kpf; пытается остановить вас при установке общего ресурса занятый другим ресурсом порт, например вашего <quote
>реального</quote
> веб-сервера. </para>

      <para
>Если вы видите пиктограмму <guiicon
>повреждённое соединение</guiicon
>, щёлкните на ней <mousebutton
>левой</mousebutton
> кнопкой мыши и выберите <guimenuitem
>Настроить...</guimenuitem
> Теперь попробуйте изменить порт и нажать <guibutton
>Ok</guibutton
>. Предполагается что на этот раз вы выбрали свободный порт, вы должны увидеть что пиктограмма <guiicon
>повреждённое соединение</guiicon
> должна исчезнуть, и теперь вы будете способны соединяться с ресурсом. </para>

    </sect1>

    <sect1 id="bandwidth-limit">

      <title
>Ограничение скорости</title>

      <para
>Термин <quote
>скорость</quote
> означает количество данных, которые могут быть переданы по соединению в единицу времени. Технически это можно выразить как <quote
>диаметр</quote
> <quote
>трубы</quote
>. </para>

      <para
>&kpf; позволяет установить ограничение  скорости используемой для конкурентного предоставленного ресурса. Это полезно, когда вы хотите ограничить использование вашего сетевого соединения людьми загружающими данные из ваших предоставленныхкаталогов. Если вы, например, используете модем, ваша скорость не достигает несколько килобайт в секунду. Ограничение скорости используемое для предоставленных ресурсов &kpf; позволяет вам оставить часть пропускной способности для себя. </para>

      <para
>Как было сказано, &kpf; измеряет пропускную способность в килобайтах в секунду или kB/s для краткости. Обычный модем поддерживает в среднем 5kB/s. Таким образом ограничивая общее использование канала всеми предоставленными ресурсами &kpf; меньшим значением, будет хорошим решением. Но всё зависит от того как вы собираетесь использовать &kpf;. </para>

    </sect1>

    <sect1 id="follow-symlinks">

      <title
>Следовать символическим ссылкам</title>

      <para
>Символическая ссылка является специальным файлом, который указывает на другой файл (или каталог) в вашей файловой системе. Следуя по ссылке вы достигаете упомянутого файла или каталога - поскольку ссылка является прозрачной.  </para>

      <para
>По умолчанию, предоставленный ресурс &kpf; не позволяет следовать по символическим ссылкам. Это означает, например, что если ваш предоставленый ресурс указывает на <filename class="directory"
>/your/home/folder/public_html</filename
> и вы создадите символическую ссылку внутри <filename class="directory"
>public_html</filename
>, указывающую на <filename class="directory"
>/tmp</filename
>, тогода любой кто запросит содержимое каталога <filename class="directory"
>public_html/tmp</filename
> увидит содержимое каталога <filename
>/tmp</filename
>. </para>

      <para
>В общем, разрешить следование символическим ссылкам в этом случае будет плохой идеей. Основная причина разрешения этого - позволить вам использовать в предоставленном каталоге символические ссылки, указывающие на другие места в этом-же каталоге. Это может быть полезным, если вы предоставляете <quote
>веб-сайт</quote
> что, как упомянуто выше, не является основным предназначением &kpf;. </para>

      <para
>Будьте внимательны, чтобы не создать ссылку на часть вашей файловой системы, содержащую конфиденциальную информацию (или иметь в этом месте символическую ссылку, на конфиденциальную информацию!) </para>

    </sect1>

  </chapter>

  <chapter id="faq">

    <title
>Вопросы и ответы</title>

    <qandaset id="faq-questions">

      <qandaentry>

        <question>
          <para
>Почему &kpf; не содержит никаких механизмов безопасности? </para>
        </question>

        <answer>

          <para
>По правде говоря, &kpf; действительно включает некоторые меры, предназначенные для предотвращение случайного предоставления доступа к конфиденциальной информации. Однако защита паролем и шифрование не предусмотрены. Это соответствует дизайну, и так должно объясняться. </para>

          <para
>Чем больше мер защиты добавляются к службе, там выше уверенность в безопасности людей, которые её  используют. Но чтобы гарантировать реальную защиту, пользователь должен хорошо понимать суть проблемы. Например, предоставление парольной защиты бесполезно, если пользователь не знает как выбрать хороший пароль. Поэтому было принято решение обеспечить нулевую защиту, в надежде что пользователи найдут что это означает вместо того чтобы тратить месяцы и годы на изучение сложностей сетевой безопасности. </para>

          <para
>Концепция проста. Если вы определили, что каталог является общедоступным, он доступен всему миру. Если вы этого не хотите, не предоставляйте к нему доступ. </para>

        </answer>

      </qandaentry>

    </qandaset>

  </chapter>

  <chapter id="credits">

    <title
>Авторские права и лицензия</title>

    <para
>&kpf; </para>

    <para
>Авторское право на программу 2002 Rik Hemsley <email
>rik@kde.org</email
> </para>

    <para
>Авторское право на документацию 2002 by Rik Hemsley <email
>rik@kde.org</email
> </para>
&underFDL; <para
>&kpf; распространяется по лицензии MIT. </para>

  </chapter>

  <appendix id="installation">

    <title
>Установка</title>

    <sect1 id="getting-kpf">

      <title
>Как получить &kpf;</title>
&install.intro.documentation; </sect1>

  </appendix>

  &documentation.index; 

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->

<!-- vim:tabstop=2:shiftwidth=2:expandtab -->
