1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/mirrors-qrcp

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
Внести вклад в разработку кода
Синхронизировать код
Отмена
Подсказка: Поскольку Git не поддерживает пустые директории, создание директории приведёт к созданию пустого файла .keep.
Loading...
README.md

Все параметры конфигурации можно контролировать через переменные среды, начинающиеся с QRCP_, например:

  • $QRCP_INTERFACE
  • $QRCP_PORT
  • $QRCP_KEEPALIVE
  • и т. д.

Config Wizard

Команда config запускает мастер настройки, который позволяет настроить такие параметры, как интерфейс, порт, полное доменное имя и поддержку активности.

qrcp config

Примечание: если некоторые сетевые интерфейсы не отображаются, используйте флаг --list-all-interfaces, чтобы отключить фильтр интерфейсов.

qrcp --list-all-interfaces config

Файл конфигурации

Файл конфигурации по умолчанию хранится в $XDG_CONFIG_HOME/qrcp/config.yml, однако вы можете указать местоположение файла конфигурации, передав флаг --config:

qrcp --config /tmp/qrcp.yml MyDocument.pdf

Порт

По умолчанию qrcp прослушивает случайный порт. Установите переменную среды QRCP_PORT или передайте флаг --port (или -p), чтобы выбрать конкретный порт:

export QRCP_PORT=8080
qrcp MyDocument

Или:

qrcp --port 8080 MyDocument.pdf

Сетевой интерфейс

qrcp автоматически найдёт подходящий сетевой интерфейс для передачи данных. Если будет найдено более одного подходящего интерфейса, он попросит вас выбрать один из них.

Если вы хотите использовать определённый интерфейс, передайте флаг --interface (или -i):

# Веб-сервер будет виден всем компьютерам в сети интерфейса tun0
qrcp -i tun0 MyDocument.dpf

Вы также можете использовать специальное имя интерфейса any, которое привязывает веб-сервер к 0.0.0.0, делая веб-сервер видимым для всех в любой сети, даже из внешней сети.

Это полезно, когда вы хотите передать файлы со своего Amazon EC2, Digital Ocean Droplet, Google Cloud Platform Compute Instance или любого другого VPS.

qrcp -i any MyDocument.pdf

Привязка

Вместо выбора интерфейса вы можете напрямую указать адрес, к которому qrcp должен привязать веб-сервер.

qrcp --bind 10.20.30.40 MyDocument.pdf

URL

qrcp использует два шаблона для URL:

  • отправить: http://{ip address}:{port}/send/{random path}
  • получить: http://{ip address}:{port}/receive/{random path}

Доступно несколько опций, которые переопределяют эти шаблоны.

Передайте флаг --path, чтобы использовать конкретный путь для URL, например:

# Полученный URL будет
# http://{ip адрес}:{порт}/отправить/x
qrcp --path=x MyDocument.pdf

Передайте флаг --fqdn (или -d), чтобы использовать полное доменное имя вместо IP. Это полезно в сочетании с -i any, если вы используете его удалённо:

# Полученный URL будет
# http://example.com:8080/send/xYz9
qrcp --fqdn example.com -i any -p 8080 MyRemoteDocument.pdf

HTTPS

qrcp поддерживает защищённые передачи файлов с помощью HTTPS. Чтобы включить защищённую передачу, вам нужен сертификат TLS и связанный ключ.

Вы можете выбрать путь к сертификату TLS и ключам в мастере настройки qrcp, или, если хотите, вы можете передать --tls-cert и --tls-key:

qrcp --tls-cert /path/to/cert.pem --tls-key /path/to/cert.key MyDocument

Также доступен флаг --secure, который можно использовать для переопределения значения по умолчанию.

Каталог вывода по умолчанию

Открыть в браузере

Если вам нужно распечатать QR-код вне терминала, вы можете передать флаг --browser. С этим флагом qrcp всё равно распечатает QR-код на терминале, но также откроет новое окно вашего браузера по умолчанию, чтобы показать QR-код.

qrcp --browser MyDocument.pdf

Поддерживать работу сервера

Может быть полезно поддерживать работу сервера после передачи файла, например, когда вы хотите перенести один и тот же файл на несколько устройств. Для этого вы можете использовать флаг --keep-alive:

# Сервер не будет автоматически завершать работу
# после первой передачи
qrcp --keep-alive MyDocument.pdf

Скрипты завершения работы оболочки

В qrcp есть встроенная команда completion, которая генерирует сценарии завершения работы оболочки.

Bash:

$ source <(qrcp completion bash)

Чтобы загрузить дополнения для каждого сеанса, выполните один раз:

Linux:

$ qrcp completion bash > **Перевод текста на русский язык:**

/etc/bash_completion.d/qrcp

Примечание: если вы не хотите устанавливать сценарии завершения системы, обратитесь к часто задаваемым вопросам по Bash Completion (Bash Completion FAQ) (https://github.com/scop/bash-completion/blob/master/README.md).

MacOS:

$ qrcp completion bash > /usr/local/etc/bash_completion.d/qrcp

Zsh:

Если автозаполнение оболочки ещё не включено в вашей среде, вам необходимо его включить. Вы можете выполнить следующее один раз:

$ echo "autoload -U compinit; compinit" >> ~/.zshrc

Чтобы загрузить дополнения для каждого сеанса, выполните один раз:

$ qrcp completion zsh > "${fpath[1]}/_qrcp"

Вам нужно будет запустить новую оболочку, чтобы изменения вступили в силу.

Fish:

$ qrcp completion fish | source

Чтобы загружать дополнения для каждого сеанса, выполните один раз:

$ qrcp completion fish > ~/.config/fish/completions/qrcp.fish

Авторы

qrcp, изначально называвшийся qr-filetransfer, начался с идеи Клаудио д'Анжелиса (claudiodangelis@gmail.com) (@claudiodangelis в Telegram), текущего сопровождающего, и разработан сообществом (https://github.com/claudiodangelis/qrcp/graphs/contributors).

Присоединяйтесь! (https://github.com/claudiodangelis/qrcp/fork)

Благодарности

Логотип предоставлен @arasatasaygin в рамках инициативы openlogos, коллекции бесплатных логотипов для проектов с открытым исходным кодом. Ознакомьтесь с правилами, чтобы получить его: правила openlogos (https://github.com/arasatasaygin/openlogos#rules).

Релизы обрабатываются с помощью goreleaser (https://goreleaser.com).

Клоны и похожие проекты

Лицензия

MIT. См. LICENSE.

Комментарии ( 0 )

Вы можете оставить комментарий после Вход в систему

Введение

Описание недоступно Развернуть Свернуть
Go
MIT
Отмена

Обновления

Пока нет обновлений

Участники

все

Недавние действия

Загрузить больше
Больше нет результатов для загрузки
1
https://api.gitlife.ru/oschina-mirror/mirrors-qrcp.git
git@api.gitlife.ru:oschina-mirror/mirrors-qrcp.git
oschina-mirror
mirrors-qrcp
mirrors-qrcp
main