The success of x-ray free-electron lasers (XFELs) in recent years has greatly advanced many scientific fields. However, most of these XFELs suffer from a low longitudinal coherence and instabilities due to the stochastic start-up process. A cavity-based x-ray free-electron laser (CBXFEL) is a possible future direction in the development of fully coherent and stable x-ray sources. One of the challenges of a CBXFEL is the requirement for the μ⁢m−sized electron bunches to fully overlap in three dimensions with the circulating μ⁢m−sized x-ray pulses in an x-ray cavity tens or hundreds of meters long. We present here the development of an x-ray diagnostics system for accurate alignment of x-ray beams in the CBXFEL cavity. The system was developed within the framework of a CBXFEL research and development collaboration among Argonne National Laboratory, SLAC National Accelerator Laboratory, and Spring-8. All the designed diagnostic components have been fully characterized at the Advanced Photon Source to demonstrate a capability for sub-μ ⁢rad angular and μ⁢m spatial alignment of the CBXFEL cavity.