v2.0.0 - persistent history support and much more
We're pleased to announce Oragono 2.0.0, a major update with a wide range of enhancements and fixes. Highlights include:
- Support for storing chat history in a MySQL backend
- Full "bouncer" functionality, including "always-on" clients that remain present on the server even when disconnected
- LDAP support contributed by @mattouille
- Support for the ratified labeled-response IRCv3 capability
- Enhanced support for Kubernetes
- Many new service commands, improving management of client certificates, vhosts, and channel ownership
Many thanks to @csmith, @mattouille, and @xPaw for contributing patches, to @csmith and @wrmsr for contributing code reviews, to @bogdomania, @brenns10, @daurnimator, @ekianjo, horseface, @ivucica, @jesopo, @jwheare, KoDi, lover, @notbandali, @poVoq, @TETYYS, and @zaher for reporting issues, and to @bogdomania and Nuve for contributing translations.
This release includes changes to the config file format, including two breaking changes:
- Backwards compatibility with the old
server.listen
format for configuring listeners has been removed; you must now use theserver.listeners
format that was introduced in 1.2.0. - The two sections
server.connection-limits
andserver.connection-throttling
have been consolidated into one new section,server.ip-limits
.
Other changes to the config file format are backwards compatible and do not require updating before restart. To minimize potential downtime, we suggest the following workflow:
- Without upgrading your
oragono
binary, edit your config file to add newserver.listeners
andserver.ip-limits
sections, based on the example config file - Rehash your server, confirming that the new config file is valid for for the previous version of the server
- Upgrade your
oragono
binary to the new 2.0.x version and restart your server - Once your deployment is stable on 2.0.x, delete the old
server.listen
,server.connection-limits
, andserver.connection-throttling
sections from your config, and rehash your server to confirm
This release includes a database change. If you have datastore.autoupgrade
set to true
in your configuration, it will be automatically applied when you restart Oragono. Otherwise, you can update the database manually by running oragono upgradedb
(see the manual for complete instructions).
Config Changes
- Desupported
server.listen
in favor ofserver.listeners
, a breaking change (#794) - Desupported
server.connection-limits
andserver.connection-throttling
in favor ofserver.ip-limits
, a breaking change (#646) - The recommended default is now to allow plaintext only on loopback interfaces (#801)
- Added
server.casemapping
option to control which Unicode nicknames and channels are allowed (#693) - Added
server.lookup-hostnames
andserver.forward-confirm-hostnames
options to control hostname lookup (#688) - Added new
limits.multiline
section to control the newdraft/multiline
capability - Added sections for enabling the optional MySQL history storage backend:
datastore.mysql
for connecting to the server andhistory.persistent
for controlling which messages are stored - Added
history.restrictions
for preventing people from retrieving arbitrarily old history messages - Added
history.znc-maxmessages
, allowing a higher history replay limit for bouncer emulation relative to CHATHISTORY - Added
accounts.vhosts.offer-list
, allowing users to take pre-approved vhosts without operator approval (#737) - Renamed
accounts.bouncer
toaccounts.multiclient
(the old name still works) (#787) - New recommended values of
server.max-sendq
,server.ip-cloaking.num-bits
,accounts.registration.bcrypt-cost
,accounts.nick-reservation.enabled
(now true),accounts.multiclient.allowed-by-default
(now true) - Added
server.ip-cloaking.secret-environment-variable
, allowing the cloaking secret to be deployed via an environment variable for use in Kubernetes (#741, thanks @daurnimator!)
Security
- Added forward confirmation of reverse DNS lookups for hostnames: to enable this, set
server.forward-confirm-hostnames
to true (#688) - Added protection against confusable channel names (#581)
- Fixed cases where Tor users could receive CTCP messages, contrary to expectations (#752, #753)
- Fixed
NS INFO
displaying the local timezone (#710) - Fixed
accounts.authentication-enabled
failing to disable theNS IDENTIFY
command (#721)
Added
- Added support for persistent history storage in MySQL (#348)
- Added support for "always-on" clients that remain present on the server even when disconnected (#348, #701)
- Added support for LDAP (#690, thanks @mattouille, @ivucica, and @mabgnu!)
- Added support for the new draft/multiline specification (#670, thanks @jwheare and @jesopo!)
- Added new modes for Unicode characters in nicknames and channel names: ASCII-only and "permissive" (allowing emoji) (#693)
- Added support for plaintext PROXY lines ahead of a TLS handshake, improving compatibility with some Kubernetes load balancers (#561, thanks @RyanSquared and @daurnimator!)
- Added support for authenticating operators by TLS client certificates, and automatically applying operator privileges on login (#696, thanks @RyanSquared!)
- Added
/DEOPER
command to remove operator privileges (#549, thanks @bogdomania!) - Added
/CHANSERV TRANSFER
, allowing transfers of channel ownership (#684) - Added
/NICKSERV CERT
, allowing users to manage their authorized client certificates (#530) - Added
/HOSTSERV TAKE
, allowing users to take pre-approved vhosts without operator approval (#737) - Added support for configuring connection limits and throttling for individual CIDRs (#646, thanks KoDi!)
- Added
/CHANSERV PURGE
, allowing server administrators to shut down channels (#683) - Added
/CHANSERV CLEAR
, allowing channel founders to reset stored bans and privileges (#692) - Added
/CHANSERV SET
, allowing channel founders to disable channel history (#379) - Added account preference
AUTOREPLAY-JOINS
, allowing greater control over when joins and parts appear in history replay (#616, thanks @zaher!) - Added
/DEBUG CRASHSERVER
command (#791) znc.in/playback
now supports nicknames as targets (#830)- Added channel mode
+C
to suppress CTCP messages to a channel (#756) - Added some missing snomasks for events related to accounts and vhosts (
+s v
to enable vhost snomasks) (#347, #103)
Changed
- Updated CHATHISTORY support to the latest draft (#621, thanks @prawnsalad!)
- Updated to the ratified labeled-response specification from the earlier
draft/labeled-response-0.2
(#757) /HISTORY
now defaults to returning 100 messages, and also takes time durations like1h
as arguments (#621, thanks lover!)- D-Lines are no longer enforced against loopback IPs (#671)
- Password length limit was reduced from 600 bytes to 300 bytes (#775)
Fixed
- Fixed a bug where
znc.in/playback
commands would play every channel, regardless of the target parameter (#760, thanks @brenns10!) - Fixed
MODE -o
not removing all operator permissions (#725, #549, thanks @bogdomania!) - Fixed client-only tags being relayed in direct messages to users without the
message-tags
capability (#754, thanks @jesopo!) - Fixed the channel user limit (the
+l
mode) not persisting after server restart (#705, thanks @bogdomania!) - Fixed response to
JOIN
lines with parameters ending in a comma (#679, thanks @bogdomania!) - Fixed confusable protection not being removed from unregistered accounts (#745, thanks @bogdomania!)
- Fixed rehash not enabling nickname reservation, vhosts, or history under some circumstances (#702, thanks @bogdomania!)
- Fixed responses to the
USERHOST
command (#682) - Fixed bad results when running
oragono upgradedb
against a missing database file (#715, thanks @bogdomania!) - Fixed confusing
NS GHOST
behavior when nickname reservation is disabled (#727, thanks horseface!) - Fixed validation of authzid during SASL (#716, thanks @xPaw!)
- Non-ASCII characters are proactively disallowed in
ip-cloaking.netname
(#713, thanks @bogdomania!) - Limited the time during which
znc.in/playback
affects channel joins (#829)
Removed
- Removed
oragono.io/maxline-2
capability in favor of the newdraft/multiline
capability (#670, #752) - Removed
oragono.io/bnc
capability (multiclient functionality is now controllable only via server config and/NS SET MULTICLIENT
) (#787) - Removed
draft/acc
capability and relatedACC
command (#723)
Internal Notes
- Updated to Go 1.14 and modules, simplifying the build process (#699)