JarCasting
JarCasting JarCasting

TCP to Unix Socket Proxy

Listens on a TCP port and proxies connections to a UNIX domain socket.

Лицензия

Лицензия

MIT
Группа

Группа

org.rnorth
Идентификатор

Идентификатор

tcp-unix-socket-proxy
Последняя версия

Последняя версия

1.0.2
Дата

Дата
Тип

Тип

jar
Описание

Описание

TCP to Unix Socket Proxy
Listens on a TCP port and proxies connections to a UNIX domain socket.
Ссылка на сайт

Ссылка на сайт

https://github.com/rnorth/tcp-unix-socket-proxy
Система контроля версий

Система контроля версий

https://github.com/rnorth/tcp-unix-socket-proxy

Скачать tcp-unix-socket-proxy

Имя Файла Размер
tcp-unix-socket-proxy-1.0.2.pom
tcp-unix-socket-proxy-1.0.2.jar 6 KB
tcp-unix-socket-proxy-1.0.2-sources.jar 5 KB
tcp-unix-socket-proxy-1.0.2-javadoc.jar 24 KB
Обзор

Как подключить последнюю версию

<!-- https://jarcasting.com/artifacts/org.rnorth/tcp-unix-socket-proxy/ -->
<dependency>
    <groupId>org.rnorth</groupId>
    <artifactId>tcp-unix-socket-proxy</artifactId>
    <version>1.0.2</version>
</dependency>
// https://jarcasting.com/artifacts/org.rnorth/tcp-unix-socket-proxy/
implementation 'org.rnorth:tcp-unix-socket-proxy:1.0.2'
// https://jarcasting.com/artifacts/org.rnorth/tcp-unix-socket-proxy/
implementation ("org.rnorth:tcp-unix-socket-proxy:1.0.2")
'org.rnorth:tcp-unix-socket-proxy:jar:1.0.2'
<dependency org="org.rnorth" name="tcp-unix-socket-proxy" rev="1.0.2">
  <artifact name="tcp-unix-socket-proxy" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.rnorth', module='tcp-unix-socket-proxy', version='1.0.2')
)
libraryDependencies += "org.rnorth" % "tcp-unix-socket-proxy" % "1.0.2"
[org.rnorth/tcp-unix-socket-proxy "1.0.2"]

Зависимости

compile (3)

Идентификатор библиотеки Тип Версия
com.kohlschutter.junixsocket : junixsocket-native-common jar 2.0.4
com.kohlschutter.junixsocket : junixsocket-common jar 2.0.4
org.slf4j : slf4j-api jar 1.7.21

test (1)

Идентификатор библиотеки Тип Версия
org.slf4j : slf4j-simple jar 1.7.21

Модули Проекта

Данный проект не имеет модулей.

TcpToUnixSocketProxy

Listens on a TCP port and proxies connections to a UNIX domain socket.

Like socat TCP-LISTEN:2375,fork UNIX-CONNECT:/var/tmp/docker.sock, except this is literally the only thing this program does.

Purposefully simplistic in implementation, potentially buggy or suboptimal in performance, may contain nuts.

This proxy uses Christian Kohlschütter's junixsocket library for interaction with Unix sockets.

Rationale

This was implemented as a short term workaround for incompatibility between netty and Docker for Mac beta's use of unix domain sockets on OS X - described here.

Caveats

This proxy uses a deliberately simple blocking I/O with threads model, purely for simplicity. This clearly eliminates the performance advantages of using netty in docker-java. However, I feel that in most cases the performance of the docker API is not a critical factor, and a working but slow solution is preferable in the short term. Still, once kqueue support for netty is in place, that will become the better solution.

This library is only useful on OS X; Linux unix socket support through epoll is well supported by netty.

Usage

Instantiate a proxy instance:

TcpToUnixSocketProxy proxy = new TcpToUnixSocketProxy(new File("/var/run/docker.sock"));

Start it, and obtain the listening address (localhost with a random port by default):

InetSocketAddress address = proxy.start();

Use the proxy by connecting to localhost on the port given by address.getPort().

Then when the proxy is no longer needed:

proxy.stop();

License

See LICENSE.

Copyright

Copyright (c) 2016 Richard North.

Версии библиотеки

Версия
1.0.2
1.0.1